Docker : les commandes essentielles pour lancer, arrêter et nettoyer ses conteneurs

Conteneurs logiciels organisés autour d’un terminal abstrait

Docker permet de lancer une application dans un conteneur : un environnement isolé qui contient tout ce dont elle a besoin. Une poignée de commandes suffisent pour démarrer, surveiller et nettoyer ses conteneurs. Voici celles à connaître, avec leurs options les plus utiles, et les pièges qui font perdre du temps aux débutants.

Vérifier que Docker fonctionne

docker --version affiche la version installée. docker run hello-world télécharge une minuscule image de test et affiche un message de bienvenue : si vous le voyez, Docker est opérationnel. Sous Linux, ajoutez votre utilisateur au groupe docker pour éviter de taper sudo à chaque commande (puis reconnectez-vous). Sous Windows et macOS, Docker Desktop doit être lancé.

Lancer un conteneur : docker run

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

ÉlémentRôle
-dDétaché : le conteneur tourne en arrière-plan
--name webDonne un nom lisible au conteneur
-p 8080:80Publie le port 80 du conteneur sur le port 8080 de votre machine
nginxL’image à utiliser (téléchargée si elle n’existe pas)

Après cette commande, ouvrez http://localhost:8080 : la page d’accueil de nginx s’affiche. Quelques options utiles en plus : -e VARIABLE=valeur pour définir une variable d’environnement, -v dossier:/chemin pour monter un dossier ou un volume, --restart unless-stopped pour redémarrer automatiquement, --rm pour supprimer le conteneur à son arrêt.

Voir ce qui tourne

  • docker ps : les conteneurs en cours d’exécution.
  • docker ps -a : tous les conteneurs, y compris arrêtés.
  • docker logs -f web : les journaux du conteneur « web », en continu (Ctrl + C pour quitter).
  • docker stats : l’utilisation en direct du processeur et de la mémoire.
  • docker inspect web : tous les détails de configuration au format JSON.
Lire aussi :  Installer une police sur Windows 10 et 11 : méthodes rapides et dépannage

Arrêter, démarrer, supprimer

  • docker stop web : arrête proprement le conteneur.
  • docker start web : le redémarre.
  • docker restart web : arrêt puis démarrage.
  • docker rm web : supprime un conteneur arrêté (-f pour forcer sur un conteneur actif).

Entrer dans un conteneur : docker exec

docker exec -it web sh ouvre un terminal interactif dans le conteneur (utilisez bash si l’image l’inclut). Pratique pour examiner un fichier de configuration ou tester une commande, mais ne modifiez pas durablement un conteneur à la main : les changements disparaissent quand il est recréé. Pour les conserver, passez par une image ou un volume.

Gérer les images

  • docker images : liste les images locales.
  • docker pull nginx : télécharge (ou met à jour) une image.
  • docker rmi nginx : supprime une image.
  • docker build -t monimage . : construit une image depuis un fichier Dockerfile du dossier courant.

Volumes et réseaux : garder ses données

Un conteneur est éphémère : ce qu’il écrit disparaît avec lui. Pour conserver des données (base de données, fichiers d’une application), utilisez un volume :

docker volume create donnees
docker run -d -v donnees:/var/lib/data mon-appli

Pour que plusieurs conteneurs communiquent, placez-les sur le même réseau : docker network create reseau, puis --network reseau au lancement. Ils se joignent alors par leur nom. Pensez à sauvegarder le contenu des volumes : voir PRA et PCA.

Docker Compose : plusieurs services dans un fichier

Dès qu’une application comporte plusieurs conteneurs (site, base de données, cache), on décrit le tout dans un fichier compose.yaml et on le pilote avec :

  • docker compose up -d : crée et démarre les services en arrière-plan.
  • docker compose ps et docker compose logs -f : état et journaux.
  • docker compose down : arrête et supprime les conteneurs (les volumes sont conservés par défaut).
  • docker compose pull puis up -d : met à jour les images.

Un exemple concret de fichier Compose se trouve dans notre guide d’installation de Vaultwarden, et un autre cas d’usage avec Open WebUI et Ollama.

Lire aussi :  Envoi différé Outlook : comment programmer un e-mail selon votre version

Nettoyer sans rien casser

Avec le temps, Docker accumule des images et des conteneurs inutiles qui prennent de la place.

  • docker system df : voir ce qui occupe l’espace.
  • docker container prune : supprime les conteneurs arrêtés.
  • docker image prune : supprime les images « orphelines ».
  • docker system prune : nettoyage général (conteneurs arrêtés, réseaux et images inutilisés). Attention : n’ajoutez --volumes que si vous êtes certain de ne plus avoir besoin des données des volumes non utilisés.

Les pièges des débutants

  • « port is already allocated » : le port de votre machine est déjà pris. Changez le premier numéro dans -p.
  • Le conteneur s’arrête aussitôt : consultez docker logs nom pour voir l’erreur.
  • Données perdues : aucun volume n’avait été monté.
  • « permission denied » : votre utilisateur n’est pas dans le groupe docker, ou le dossier monté n’a pas les bons droits.
  • Service inaccessible de l’extérieur : vérifiez le pare-feu et testez avec un test de port.

Questions fréquentes

Quelle différence entre une image et un conteneur ?

L’image est le modèle, en lecture seule. Le conteneur est une instance en cours d’exécution de cette image.

Docker est-il une machine virtuelle ?

Non : les conteneurs partagent le noyau du système hôte, ce qui les rend plus légers et plus rapides à démarrer qu’une machine virtuelle complète.

Quelle est la commande pour lancer Docker ?

Docker tourne en tant que service : sous Linux, sudo systemctl start docker ; sous Windows et macOS, lancez l’application Docker Desktop.

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *