Installer Docker sur Debian

Docker fait tourner une application dans un environnement isolé, avec ses propres bibliothèques et ses propres fichiers, mais sur le noyau de la machine hôte. C’est ce dernier point qui fait toute la différence avec une machine virtuelle : pas de second système d’exploitation à démarrer, donc un conteneur qui se lance en une seconde et pèse quelques dizaines de mégaoctets.

Étape 1 : installer Docker depuis le dépôt officiel

Debian propose bien un paquet docker.io dans ses dépôts, mais il retarde souvent de plusieurs versions et ne fournit pas les greffons modernes. Le dépôt officiel de Docker demande quatre étapes de plus et donne une installation à jour et complète.

1. Installer les prérequis

   sudo apt update && sudo apt install ca-certificates curl

   ca-certificates fournit les autorités de certification nécessaires pour valider le HTTPS du dépôt, curl sert à télécharger la clé.

2. Récupérer la clé de signature

   sudo install -m 0755 -d /etc/apt/keyrings
   sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
   sudo chmod a+r /etc/apt/keyrings/docker.asc

   ExplicationÀ quoi sert cette clé

   Chaque paquet du dépôt Docker est signé cryptographiquement. Sans cette clé publique, apt refuse d’installer quoi que ce soit, car il ne peut pas vérifier que le paquet vient bien de Docker et n’a pas été modifié en chemin. C’est ce qui protège contre un dépôt compromis ou une interception réseau.

   Noteapt-key est obsolète

   Les tutoriels antérieurs à Debian 11 utilisent apt-key add, qui installe la clé dans un trousseau global : elle devient alors habilitée à signer n’importe quel paquet du système, y compris ceux des dépôts Debian. La méthode actuelle range la clé dans /etc/apt/keyrings et la lie explicitement à un seul dépôt avec l’option signed-by, ce qui limite sa portée.

3. Déclarer le dépôt

   echo \
     "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
     $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
     sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

   Les deux substitutions rendent la ligne portable : dpkg --print-architecture renvoie l’architecture de la machine (amd64, arm64), et VERSION_CODENAME le nom de la version de Debian (bookworm, trixie). Vous pouvez copier ce bloc tel quel sur n’importe quelle machine.

4. Installer les paquets

   sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

   Paquet	Rôle
   docker-ce	le démon, qui fait tourner les conteneurs
   docker-ce-cli	la commande docker que vous tapez
   containerd.io	le moteur d’exécution bas niveau, utilisé par le démon
   docker-buildx-plugin	construction d’images, y compris multi-architectures
   docker-compose-plugin	la commande docker compose, pour décrire plusieurs conteneurs dans un fichier

   AstuceClient et démon sont deux choses distinctes

   La commande docker ne fait rien elle-même : elle transmet vos ordres au démon, qui tourne en arrière-plan en tant que root. Cette séparation explique pourquoi sudo est nécessaire par défaut, et c’est l’objet de l’étape suivante.

5. Vérifier que le service tourne

   sudo systemctl enable --now docker
   sudo systemctl status docker

   enable --now démarre le service et le programme au démarrage de la machine, ce qui évite de découvrir après un redémarrage que les conteneurs ne sont pas revenus.

6. Valider l'installation

   sudo docker run hello-world

   Hello from Docker!
   This message shows that your installation appears to be working correctly.
   
   To generate this message, Docker took the following steps:
   1. The Docker client contacted the Docker daemon.
   2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
       (amd64)
   3. The Docker daemon created a new container from that image which runs the
       executable that produces the output you are currently reading.
   4. The Docker daemon streamed that output to the Docker client, which sent it
       to your terminal.
   
   To try something more ambitious, you can run an Ubuntu container with:
   $ docker run -it ubuntu bash
   
   Share images, automate workflows, and more with a free Docker ID:
   https://hub.docker.com/
   
   For more examples and ideas, visit:
   https://docs.docker.com/get-started/

   Ce message n’est pas un simple « ça marche » : il décrit exactement la chaîne que Docker vient de parcourir, du client au démon, du démon au registre, puis du registre au conteneur. Si vous le voyez, les quatre composants installés communiquent correctement.

Taper sudo devant chaque commande devient vite pénible. C’est réglable, à condition d’en mesurer la portée.

Étape 2 : utiliser Docker sans sudo

sudo usermod -aG docker $USER
newgrp docker

La première ligne ajoute votre compte au groupe docker, la seconde applique le changement à la session en cours sans avoir à se déconnecter.

Une fois le groupe en place, la commande fonctionne directement :

docker run hello-world

Passons à un conteneur qui rend un service réel.

Étape 3 : lancer un conteneur utile

À titre d’exemple, nous allons faire tourner un serveur web Apache.

docker run -d --name docker-apache -v /var/www/:/usr/local/apache2/htdocs/ -p 3000:80 httpd

Décomposons chaque partie :

Le site est alors joignable sur http://IP_MACHINE:3000, et son contenu se modifie simplement en éditant /var/www sur l’hôte.

Piloter les conteneurs au quotidien

Une poignée de commandes couvre l’essentiel de l’exploitation.

Le Docker Hub

Le Docker Hub est le registre public d’images, l’équivalent d’un magasin d’applications. On y trouve les images officielles, celles publiées par la communauté, et surtout la documentation de chacune.

Chaque image expose ses versions sous forme d’étiquettes, ainsi que les variantes de base disponibles.

La documentation d’une image indique les chemins à monter en volume, les ports exposés et les variables d’environnement attendues. C’est la première chose à lire avant de composer une commande docker run.

L’installation est fonctionnelle et vous savez piloter un conteneur. Les articles suivants de la série s’appuient sur cette base pour héberger des services réels.