Guide 02 / 3
Commandes Docker & Docker Compose
Trouver la commande adaptée à une situation et interpréter ses options.
Construire, exécuter, diagnostiquer et arrêter des services sans perdre de données.
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.
Exemple
docker version
docker info
Présente la configuration de l’Engine, ses ressources et ses fonctionnalités.
Exemple
docker info
docker ps
Liste les conteneurs en cours d’exécution. Avec -a, inclut ceux qui sont arrêtés.
Exemple
docker ps -a
docker inspect
Affiche les détails structurés d’un objet : adresse IP, montages, état, configuration, etc.
Exemple
docker inspect web
docker logs
Affiche la sortie standard et les erreurs d’un conteneur. -f suit les nouvelles lignes en temps réel.
Exemple
docker logs -f web
docker stats
Présente l’utilisation CPU et mémoire en temps réel des conteneurs.
Exemple
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.
Exemple
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.
Exemple
docker pull nginx:alpine
docker image ls
Affiche les images présentes localement et leurs tags.
Exemple
docker image ls
docker build
Construit une image depuis un Dockerfile. -t définit son nom/tag ; le point indique le contexte courant.
Exemple
docker build -t monsite:1.0 .
docker image rm
Supprime une image locale non utilisée, sans supprimer un registre distant.
Exemple
docker image rm monsite:1.0
Peut échouer si l’image est utilisée par un conteneur.
docker tag
Ajoute une nouvelle référence (nom/tag) à une image existante.
Exemple
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.
Exemple
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.
Exemple
docker run -d --name web -p 8080:80 nginx:alpine
docker create
Crée un conteneur sans le démarrer.
Exemple
docker create --name test nginx:alpine
docker start
Démarre un conteneur existant arrêté, sans en créer un nouveau.
Exemple
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.
Exemple
docker stop web
docker restart
Redémarre un conteneur existant.
Exemple
docker restart web
docker rm
Supprime un conteneur arrêté. Les volumes nommés ne sont normalement pas supprimés avec lui.
Exemple
docker rm web
Vérifier les données avant suppression.
docker cp
Copie des fichiers entre l’hôte et un conteneur.
Exemple
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.
Exemple
docker volume ls
docker volume create
Crée un volume nommé.
Exemple
docker volume create donnees
docker volume inspect
Affiche notamment le point de montage et le pilote d’un volume.
Exemple
docker volume inspect donnees
docker network ls
Liste les réseaux Docker.
Exemple
docker network ls
docker network create
Crée un réseau utilisable pour relier des conteneurs.
Exemple
docker network create atelier
docker network inspect
Affiche les caractéristiques d’un réseau et ses conteneurs connectés.
Exemple
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.
Exemple
docker compose version
docker compose config
Vérifie, fusionne et affiche la configuration Compose résolue. À utiliser avant de démarrer.
Exemple
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.
Exemple
docker compose up -d --build
docker compose ps
Liste les conteneurs du projet Compose courant et leur état.
Exemple
docker compose ps
docker compose logs
Affiche les journaux des services. -f suit la sortie ; un nom de service cible un service précis.
Exemple
docker compose logs -f web
docker compose exec
Lance une commande dans le conteneur déjà actif d’un service.
Exemple
docker compose exec web sh
docker compose run
Crée un conteneur ponctuel pour exécuter une commande d’un service.
Exemple
docker compose run --rm web npm test
docker compose build
Construit ou reconstruit les images des services qui possèdent build.
Exemple
docker compose build web
docker compose pull
Télécharge les images référencées dans la configuration.
Exemple
docker compose pull
docker compose stop
Arrête les services sans supprimer les conteneurs du projet.
Exemple
docker compose stop
docker compose start
Relance des conteneurs existants précédemment arrêtés.
Exemple
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.
Exemple
docker compose down
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.
Exemple
docker run --rm -it alpine sh
-p / -v / --name
-p publie un port ; -v monte un volume ou dossier ; --name attribue un nom.
Exemple
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.
Exemple
docker run --env NODE_ENV=production monsite:1.0
docker system df
Affiche l’espace utilisé par les images, conteneurs et volumes.
Exemple
docker system df
docker system prune
Supprime certaines ressources inutilisées (notamment conteneurs arrêtés, réseaux inutilisés et caches selon options).
Exemple
docker system prune
Faire un inventaire avant usage ; -a élargit le nettoyage et --volumes peut supprimer des volumes inutilisés.