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
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.
sudo apt install -y docker.io docker-compose curlL'installation défile pendant une minute. Vérifions ensuite que les deux commandes répondent.
sudo docker --version
sudo docker compose versionDocker version 26.1.5+dfsg1, build a72d7cd
Docker Compose version 2.26.1-4Installer 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.
sudo docker run hello-worldHello 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 :
-dle lance en arrière-plan, pour que vous gardiez la main.--name weblui donne un nom que vous retiendrez.-p 127.0.0.1:8081:80relie le port 8081 du serveur au port 80 du conteneur. Le127.0.0.1en 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.
sudo docker run -d --name web -p 127.0.0.1:8081:80 nginx:1.30-alpineDocker 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.
sudo docker psCONTAINER 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 webDemandons maintenant sa page au conteneur. Le 200 OK de la réponse veut dire « page servie ».
curl -sI http://127.0.0.1:8081 | head -1HTTP/1.1 200 OKSi 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 webaffiche ce que le conteneur a écrit, c'est-à-dire son journal. Ajoutez-fpour suivre en direct, et quittez avec Ctrl+C.sudo docker exec web ls /usr/share/nginx/htmlexécute une commande dans la boîte, ici pour lister les fichiers de la page. Avecexec -it web sh, vous obtenez un terminal à l'intérieur.sudo docker stop webarrête le conteneur sans le supprimer.sudo docker rm weble supprime. Il faut l'arrêter d'abord.
sudo docker exec web ls /usr/share/nginx/html
sudo docker stop web
sudo docker rm web50x.html
index.html
web
webDocker 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.
sudo docker volume create donnees
sudo docker run --rm -v donnees:/donnees alpine:3.20 sh -c 'echo bonjour > /donnees/note.txt'donneesL'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.
sudo docker run --rm -v donnees:/donnees alpine:3.20 cat /donnees/note.txtbonjourLe 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 :
sudo docker volume rm donneesdonneesNous 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.
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.
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
EOFLes 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.
sudo docker compose up -d
sudo docker compose psNAME 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/tcpCompose 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.
curl -s http://127.0.0.1:8081<h1>Bonjour depuis mon-serveur</h1>Trois commandes sont à retenir, à lancer depuis le dossier du fichier :
sudo docker compose logsaffiche le journal de tous les services du fichier.sudo docker compose downarrête et supprime les conteneurs et le réseau. Vos volumes et votre dossierhtmlrestent intacts.sudo docker compose down -vsupprime 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é.
sudo docker compose pull
sudo docker compose up -dSi 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.
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}}"NAMES PORTS
prive 127.0.0.1:8082->80/tcp
ouvert 0.0.0.0:8081->80/tcp, [::]:8081->80/tcpLe 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.
sudo docker rm -f ouvert priveouvert
priveRetenez la règle, écriture par écriture :
| Écriture | Qui 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 ports | Seulement 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 thesuivi d'un chemin endocker.sock. Vous avez oubliésudodevantdocker.no configuration file provided: not found. Vous n'êtes pas dans le dossier qui contientdocker-compose.yml. Uncd ~/mon-siterè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 colonnePORTSdesudo 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 avecsudo 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.