Anime-Sanctuary

Docker et Docker Compose

Chaque application que vous installez à la main apporte ses réglages et ses dépendances, et elles finissent par se marcher dessus. Docker range chaque application dans sa boîte, et Docker Compose décrit toutes les boîtes dans un seul fichier.

Parcours
Tutoriel 21 sur 35
Durée
35 min de lecture
Vérifié avec
Commandes : essais sous Debian 13
Ce que vous saurez faire
  • Installer Docker et Docker Compose depuis les paquets de Debian.
  • Lancer, observer et supprimer un conteneur.
  • Garder des données dans un volume.
  • Décrire un service dans un fichier docker-compose.yml, le démarrer et le mettre à jour.
  • Éviter que Docker ouvre un port que votre pare-feu croit fermé.

Avant de commencer : Mises à jour et paquets, Utilisateurs, sudo et droits.

Sommaire
  1. Un conteneur, c'est une boîte isolée
  2. Installer Docker
  3. Lancer un premier conteneur
  4. Faire tourner un vrai service
  5. Garder les données dans un volume
  6. Décrire le service dans un fichier Compose
  7. Le piège : Docker ouvre des ports malgré ufw
  8. Si ça échoue
  9. Questions fréquentes
  10. La suite
  11. Sources

Comment installer Docker et Docker Compose sur Debian ? Avec deux paquets et quelques commandes, comptez une demi-heure. Vos applications s'installent en une ligne, se suppriment sans laisser de traces, et ne se disputent plus les mêmes fichiers. Un piège vous attend aussi du côté du pare-feu : nous le désamorcerons avant qu'il serve.

Un conteneur, c'est une boîte isolée

Un conteneur est une boîte fermée posée sur votre serveur : l'application y trouve ses propres fichiers et ses propres réglages, et ne voit pas le reste. Si elle se casse, elle casse sa boîte et rien d'autre. Si vous n'en voulez plus, vous jetez la boîte et le serveur reste propre.

Ce n'est pas une machine virtuelle, c'est-à-dire un faux ordinateur complet avec son propre système. Le conteneur emprunte le système de votre serveur et n'isole que l'application. Il démarre donc en une seconde et pèse peu.

Deux mots reviendront tout du long, et il ne faut pas les confondre :

  • Une image est le modèle figé d'une application, comme une recette. Elle ne bouge pas et se télécharge.
  • Un conteneur est une image en train de tourner, comme le plat préparé avec la recette. Avec une même image, on en lance autant qu'on veut.

Docker est le programme qui télécharge les images et lance les conteneurs. Installons-le.

1Installer Docker

Debian fournit Docker sous forme de paquets, des logiciels prêts à installer : docker.io pour le programme, et docker-compose pour Compose. Malgré son nom, le second apporte la commande moderne docker compose, avec un espace. Nous ajoutons curl, qui demande une page web depuis le terminal et nous servira à tester.

Sur le serveur
sudo apt install -y docker.io docker-compose curl

L'installation défile pendant une minute. Vérifions ensuite que les deux commandes répondent.

Sur le serveur
sudo docker --version
sudo docker compose version
Résultat attendu
Docker version 26.1.5+dfsg1, build a72d7cd
Docker Compose version 2.26.1-4
Installer Docker depuis la boutique de Docker (facultatif)

Docker tient sa propre boutique de logiciels, appelée dépôt, à côté de celle de Debian. Ses paquets sont plus récents. Pour un serveur personnel, ceux de Debian suffisent et se mettent à jour avec le reste du système. Si vous voulez la dernière version, retirez d'abord docker.io puis suivez la page « Install Docker Engine on Debian » citée dans les sources.

Docker est prêt. Vérifions qu'il sait vraiment lancer quelque chose.

2Lancer un premier conteneur

La commande docker run télécharge une image si elle manque, crée un conteneur avec, et le démarre. L'image hello-world est faite pour ce test : elle affiche un message, puis s'arrête.

Sur le serveur
sudo docker run hello-world
Résultat attendu
Hello from Docker!
This message shows that your installation appears to be working correctly.

Au-dessus de ces lignes, Docker a affiché le téléchargement de l'image depuis le Docker Hub, le catalogue public d'images. Le message dit que tout marche : Docker a trouvé l'image, créé le conteneur, et celui-ci s'est arrêté une fois son message écrit. Voyons maintenant un conteneur qui reste allumé.

3Faire tourner un vrai service

Lançons nginx, un serveur web, dans un conteneur nommé web. Trois options de docker run comptent :

  • -d le lance en arrière-plan, pour que vous gardiez la main.
  • --name web lui donne un nom que vous retiendrez.
  • -p 127.0.0.1:8081:80 relie le port 8081 du serveur au port 80 du conteneur. Le 127.0.0.1 en tête réserve ce port au serveur lui-même.

Ce dernier détail protège votre machine : la section sur les ports explique pourquoi.

Sur le serveur
sudo docker run -d --name web -p 127.0.0.1:8081:80 nginx:1.30-alpine

Docker répond par une longue suite de lettres et de chiffres, l'identifiant du conteneur. La commande docker ps liste les conteneurs en marche. Vos identifiants et vos durées seront différents.

Sur le serveur
sudo docker ps
Résultat attendu
CONTAINER ID   IMAGE               COMMAND                  CREATED        STATUS                  PORTS                    NAMES
398d49d517b9   nginx:1.30-alpine   "/docker-entrypoint..."   1 second ago   Up Less than a second   127.0.0.1:8081->80/tcp   web

Demandons maintenant sa page au conteneur. Le 200 OK de la réponse veut dire « page servie ».

Sur le serveur
curl -sI http://127.0.0.1:8081 | head -1
Résultat attendu
HTTP/1.1 200 OK

Si rien ne s'affiche, patientez deux secondes, le temps que nginx démarre, puis relancez. Quatre commandes servent ensuite tous les jours :

  • sudo docker logs web affiche ce que le conteneur a écrit, c'est-à-dire son journal. Ajoutez -f pour suivre en direct, et quittez avec Ctrl+C.
  • sudo docker exec web ls /usr/share/nginx/html exécute une commande dans la boîte, ici pour lister les fichiers de la page. Avec exec -it web sh, vous obtenez un terminal à l'intérieur.
  • sudo docker stop web arrête le conteneur sans le supprimer.
  • sudo docker rm web le supprime. Il faut l'arrêter d'abord.
Sur le serveur
sudo docker exec web ls /usr/share/nginx/html
sudo docker stop web
sudo docker rm web
Résultat attendu
50x.html
index.html
web
web

Docker a listé deux fichiers, puis répété le nom du conteneur à l'arrêt et à la suppression. Le conteneur n'existe plus, et tout ce qu'il contenait a disparu avec lui. C'est pratique pour faire le ménage, mais gênant pour une base de données : il faut un endroit qui survive à la boîte.

4Garder les données dans un volume

Un volume est un dossier géré par Docker, rangé hors des conteneurs, que l'on branche sur une boîte. Les données qu'on y écrit survivent à la suppression du conteneur. Créons un volume nommé donnees et écrivons un fichier dedans, depuis un premier conteneur. alpine:3.20 est une image Linux minuscule, prise juste pour lancer une commande.

Sur le serveur
sudo docker volume create donnees
sudo docker run --rm -v donnees:/donnees alpine:3.20 sh -c 'echo bonjour > /donnees/note.txt'
Résultat attendu
donnees

L'option -v donnees:/donnees branche le volume sur le dossier /donnees du conteneur, et --rm supprime le conteneur dès qu'il a fini. Il a donc disparu. Lançons-en un second, tout neuf, et lisons le fichier.

Sur le serveur
sudo docker run --rm -v donnees:/donnees alpine:3.20 cat /donnees/note.txt
Résultat attendu
bonjour

Le fichier a survécu au premier conteneur et le second le retrouve. C'est ainsi que Nextcloud gardera vos fichiers dans l'article suivant. Pour effacer le volume, et ses données avec, vous le nommez explicitement :

Sur le serveur
sudo docker volume rm donnees
Résultat attendu
donnees

Nous savons lancer une boîte et lui garder ses données. Mais retaper ces longues commandes devient vite pénible, et on finit par oublier une option. Un fichier va s'en charger pour nous.

5Décrire le service dans un fichier Compose

Docker Compose lit un fichier nommé docker-compose.yml, qui décrit vos conteneurs, et les démarre tous d'une commande. Le fichier est écrit en YAML, un format où l'espace en début de ligne montre ce qui appartient à quoi. Créons un dossier pour notre site, avec une page d'accueil.

Sur le serveur
mkdir -p ~/mon-site/html
cd ~/mon-site
echo '<h1>Bonjour depuis mon-serveur</h1>' > html/index.html

Écrivons ensuite le fichier. Il reprend nos options de tout à l'heure : l'image, le port réservé au serveur, et le dossier html branché sur celui de nginx. Le :ro veut dire « lecture seule ». Le restart: unless-stopped relance le conteneur après un redémarrage du serveur, sauf si vous l'avez arrêté vous-même.

Sur le serveur
cat > docker-compose.yml <<'EOF'
services:
  web:
    image: nginx:1.30-alpine
    restart: unless-stopped
    ports:
      - "127.0.0.1:8081:80"
    volumes:
      - ./html:/usr/share/nginx/html:ro
EOF

Les espaces en début de ligne comptent, et une tabulation à leur place fait échouer la commande. Démarrons, avec -d pour l'arrière-plan comme tout à l'heure. Docker crée un réseau privé pour le projet, puis le conteneur.

Sur le serveur
sudo docker compose up -d
sudo docker compose ps
Résultat attendu
NAME             IMAGE               COMMAND                  SERVICE   CREATED         STATUS         PORTS
mon-site-web-1   nginx:1.30-alpine   "/docker-entrypoint..."   web       3 seconds ago   Up 2 seconds   127.0.0.1:8081->80/tcp

Compose a nommé le conteneur d'après le dossier : mon-site, le service web, et un numéro. Vérifions que la page est la nôtre.

Sur le serveur
curl -s http://127.0.0.1:8081
Résultat attendu
<h1>Bonjour depuis mon-serveur</h1>

Trois commandes sont à retenir, à lancer depuis le dossier du fichier :

  • sudo docker compose logs affiche le journal de tous les services du fichier.
  • sudo docker compose down arrête et supprime les conteneurs et le réseau. Vos volumes et votre dossier html restent intacts.
  • sudo docker compose down -v supprime en plus les volumes, donc les données. Réservez-la au vrai ménage.

Reste la mise à jour. Une image est figée : pour avoir une version plus récente, on la télécharge à nouveau, puis on relance. Compose ne recrée que les conteneurs dont l'image a changé.

Sur le serveur
sudo docker compose pull
sudo docker compose up -d

Si une version plus récente existe, Docker la télécharge, puis recrée le conteneur avec elle. Sinon il répond que tout est à jour. Ici, 1.30-alpine suit les corrections de la série 1.30. Pour passer à une série plus récente, vous changez ce nombre dans le fichier.

Votre site tourne et se met à jour proprement. Revenons à ce 127.0.0.1 qui revient dans chaque port : c'est lui qui vous évite un mauvais réveil.

Le piège : Docker ouvre des ports malgré ufw

Un port publié est une porte du conteneur que Docker ouvre sur le serveur, avec l'option -p ou la ligne ports. D'après la documentation de Docker, une telle porte reste joignable depuis Internet même si votre pare-feu ufw dit le contraire. Docker écrit ses propres règles, et les connexions vers un conteneur ne passent pas par les vôtres. Nous ne l'avons pas reproduit ici : prenez-le comme une consigne de prudence.

Voyons ce qui change selon l'écriture du port. Lançons deux conteneurs jetables, l'un ouvert, l'autre réservé au serveur, puis affichons leurs noms et leurs ports.

Sur le serveur
sudo docker run -d --name ouvert -p 8081:80 nginx:1.30-alpine
sudo docker run -d --name prive -p 127.0.0.1:8082:80 nginx:1.30-alpine
sudo docker ps --format "table {{.Names}}\t{{.Ports}}"
Résultat attendu
NAMES     PORTS
prive     127.0.0.1:8082->80/tcp
ouvert    0.0.0.0:8081->80/tcp, [::]:8081->80/tcp

Le signe 0.0.0.0 veut dire « toutes les adresses du serveur », donc aussi celle d'Internet ([::] en est l'équivalent IPv6). Sur la ligne de prive, le 127.0.0.1 réserve la porte au serveur lui-même. Supprimons ces deux conteneurs d'essai.

Sur le serveur
sudo docker rm -f ouvert prive
Résultat attendu
ouvert
prive

Retenez la règle, écriture par écriture :

ÉcritureQui peut se connecter
"8081:80"Tout Internet, même si ufw bloque ce port
"127.0.0.1:8081:80"Le serveur seul
pas de ligne portsSeulement les autres conteneurs du même fichier

Une application réservée au serveur reste invisible de l'extérieur, ce qui n'est pas toujours le but. Pour la montrer au monde, on passe par un intermédiaire qui contrôle ce qui entre : le Reverse proxy. En attendant, prenez l'habitude de mettre 127.0.0.1: devant chaque port publié.

Si ça échoue

Cinq messages reviennent, avec leur cause :

  • permission denied while trying to connect to the suivi d'un chemin en docker.sock. Vous avez oublié sudo devant docker.
  • no configuration file provided: not found. Vous n'êtes pas dans le dossier qui contient docker-compose.yml. Un cd ~/mon-site règle le problème.
  • Bind for 127.0.0.1:8081 failed: port is already allocated. Un autre conteneur, ou un autre programme, utilise déjà ce port. Lisez la colonne PORTS de sudo docker ps, puis changez le premier nombre dans votre fichier, par exemple 8082.
  • The container name "/web" is already in use. Un conteneur de ce nom existe déjà, même arrêté. Supprimez-le avec sudo docker rm web, ou choisissez un autre nom.
  • found character that cannot start any token, avec un numéro de ligne. Le YAML contient une tabulation, ou une indentation mal faite. Remplacez-la par des espaces.

Questions fréquentes

Quelle différence entre une image et un conteneur Docker ?

Une image est le modèle figé d'une application, comme une recette. Un conteneur est une image en train de tourner, et on en lance autant qu'on veut.

Comment ne pas perdre mes données en supprimant un conteneur ?

Tout ce que contient un conteneur disparaît avec lui. Branchez un volume, un dossier géré par Docker hors des conteneurs : ses données survivent.

Docker contourne-t-il le pare-feu ufw ?

D'après la documentation de Docker, un port publié reste joignable depuis Internet même si ufw le bloque. Écrivez 127.0.0.1: devant chaque port publié pour le réserver au serveur.

La suite

Vous savez installer Docker, lancer des conteneurs, leur garder des données, et publier un port sans trou dans votre pare-feu. Quand vous aurez fini vos essais, un sudo docker compose down dans ~/mon-site libère le port 8081. Il est temps de faire travailler tout cela pour de vrai. L'article suivant, Nextcloud, installe votre propre espace de fichiers en ligne avec deux conteneurs et deux volumes.