
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ément | Rôle |
|---|---|
-d | Détaché : le conteneur tourne en arrière-plan |
--name web | Donne un nom lisible au conteneur |
-p 8080:80 | Publie le port 80 du conteneur sur le port 8080 de votre machine |
nginx | L’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.
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é (-fpour 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 fichierDockerfiledu 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 donneesdocker 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 psetdocker 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 pullpuisup -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.
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--volumesque 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 nompour 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.
