Docker & Docker Compose — Le cours

Guide 02 / 3

Commandes Docker & Docker Compose

Trouver la commande adaptée à une situation et interpréter ses options.

Résultat attendu :

Construire, exécuter, diagnostiquer et arrêter des services sans perdre de données.

Lecture
0%

01 · Vérifier et observer

Une commande agit sur le client Docker ; le démon effectue ensuite l’opération. Chaque exemple suppose Docker installé et accessible depuis le terminal.

docker version

Affiche les versions du client et du serveur Docker. Permet de vérifier la communication avec Docker Engine.

docker version

docker info

Présente la configuration de l’Engine, ses ressources et ses fonctionnalités.

docker info

docker ps

Liste les conteneurs en cours d’exécution. Avec -a, inclut ceux qui sont arrêtés.

docker ps -a

docker inspect

Affiche les détails structurés d’un objet : adresse IP, montages, état, configuration, etc.

docker inspect web

docker logs

Affiche la sortie standard et les erreurs d’un conteneur. -f suit les nouvelles lignes en temps réel.

docker logs -f web

docker stats

Présente l’utilisation CPU et mémoire en temps réel des conteneurs.

docker stats

docker exec

Exécute une commande dans un conteneur déjà démarré. L’option -it ouvre une session interactive si l’outil est présent.

docker exec -it web sh

02 · Manipuler les images

Une image est un modèle : on la télécharge, la construit, la nomme puis on lance un conteneur à partir d’elle.

docker pull

Télécharge une image depuis un registre sans démarrer de conteneur.

docker pull nginx:alpine

docker image ls

Affiche les images présentes localement et leurs tags.

docker image ls

docker build

Construit une image depuis un Dockerfile. -t définit son nom/tag ; le point indique le contexte courant.

docker build -t monsite:1.0 .

docker image rm

Supprime une image locale non utilisée, sans supprimer un registre distant.

docker image rm monsite:1.0
À retenir :

Peut échouer si l’image est utilisée par un conteneur.

docker tag

Ajoute une nouvelle référence (nom/tag) à une image existante.

docker tag monsite:1.0 monsite:stable

docker push

Envoie une image vers un registre pour la rendre accessible ailleurs ; nécessite les droits adaptés.

docker push registry.example.com/monapp:1.0

03 · Cycle de vie des conteneurs

Le cycle courant suit : créer → démarrer → observer → arrêter → recréer si nécessaire.

docker run

Crée puis démarre un conteneur à partir d’une image. -d lance en arrière-plan ; -p publie un port ; --name nomme le conteneur.

docker run -d --name web -p 8080:80 nginx:alpine

docker create

Crée un conteneur sans le démarrer.

docker create --name test nginx:alpine

docker start

Démarre un conteneur existant arrêté, sans en créer un nouveau.

docker start web

docker stop

Demande l’arrêt propre d’un conteneur puis force l’arrêt au-delà du délai si nécessaire.

docker stop web

docker restart

Redémarre un conteneur existant.

docker restart web

docker rm

Supprime un conteneur arrêté. Les volumes nommés ne sont normalement pas supprimés avec lui.

docker rm web
À retenir :

Vérifier les données avant suppression.

docker cp

Copie des fichiers entre l’hôte et un conteneur.

docker cp web:/usr/share/nginx/html/index.html ./index.html

04 · Stockage et réseaux

Les volumes survivent à la recréation d’un service ; les réseaux permettent la communication par noms de services.

docker volume ls

Liste les volumes existants.

docker volume ls

docker volume create

Crée un volume nommé.

docker volume create donnees

docker volume inspect

Affiche notamment le point de montage et le pilote d’un volume.

docker volume inspect donnees

docker network ls

Liste les réseaux Docker.

docker network ls

docker network create

Crée un réseau utilisable pour relier des conteneurs.

docker network create atelier

docker network inspect

Affiche les caractéristiques d’un réseau et ses conteneurs connectés.

docker network inspect atelier

05 · Piloter une application Compose

Ces commandes doivent être lancées dans le dossier qui contient compose.yaml, ou avec -f pour préciser le fichier.

docker compose version

Affiche la version du plugin Docker Compose.

docker compose version

docker compose config

Vérifie, fusionne et affiche la configuration Compose résolue. À utiliser avant de démarrer.

docker compose config

docker compose up

Crée et démarre les services. -d détache le terminal ; --build demande de reconstruire les images concernées.

docker compose up -d --build

docker compose ps

Liste les conteneurs du projet Compose courant et leur état.

docker compose ps

docker compose logs

Affiche les journaux des services. -f suit la sortie ; un nom de service cible un service précis.

docker compose logs -f web

docker compose exec

Lance une commande dans le conteneur déjà actif d’un service.

docker compose exec web sh

docker compose run

Crée un conteneur ponctuel pour exécuter une commande d’un service.

docker compose run --rm web npm test

docker compose build

Construit ou reconstruit les images des services qui possèdent build.

docker compose build web

docker compose pull

Télécharge les images référencées dans la configuration.

docker compose pull

docker compose stop

Arrête les services sans supprimer les conteneurs du projet.

docker compose stop

docker compose start

Relance des conteneurs existants précédemment arrêtés.

docker compose start

docker compose down

Arrête et supprime les conteneurs et réseaux créés pour le projet ; les volumes nommés ne sont pas supprimés par défaut.

docker compose down
À retenir :

Avec -v, supprime aussi des volumes : risque de perte de données.

06 · Options et opérations à risque

Toujours identifier la portée d’une commande avant de l’exécuter.

-d / -it / --rm

-d détache le terminal ; -it permet l’interaction ; --rm supprime un conteneur ponctuel à son arrêt.

docker run --rm -it alpine sh

-p / -v / --name

-p publie un port ; -v monte un volume ou dossier ; --name attribue un nom.

docker run --name demo -p 8080:80 nginx:alpine

--env / --env-file

Transmet des variables d’environnement au conteneur ; les fichiers peuvent contenir des informations sensibles.

docker run --env NODE_ENV=production monsite:1.0

docker system df

Affiche l’espace utilisé par les images, conteneurs et volumes.

docker system df

docker system prune

Supprime certaines ressources inutilisées (notamment conteneurs arrêtés, réseaux inutilisés et caches selon options).

docker system prune
À retenir :

Faire un inventaire avant usage ; -a élargit le nettoyage et --volumes peut supprimer des volumes inutilisés.