Installer Docker dans la VM

Progression d’apprentissage0 / 404

0 / 27 validations dans ce chapitre

Réinitialiser la progression

Installer Engine, Compose et les droits utilisateur sans étape implicite.

Dans ce chapitre : 9 étapes et 27 preuves de validation.

Étape 5 — Identifier précisément la VM

Objectif. Tu vérifieras que les commandes d’installation correspondent à Debian.

État du projet avant cette étape. Tu es dans le terminal Linux de la VM avec sudo.

Comprendre le changement

Docker publie des dépôts différents selon la distribution et l’architecture. /etc/os-release donne la distribution ; dpkg donne l’architecture des paquets.

Repère pédagogique · p. 5

Bonne pratique : le PDF impose une VM mais ne fixe ni sa distribution ni la méthode d’installation de Docker.

Faire une seule chose

Affiche ces informations. Continue avec les commandes Debian uniquement si ID=debian. Pour Ubuntu, utilise la page officielle Ubuntu équivalente.

À EXÉCUTER DANSDans la VM · n’importe quel dossier

Copier

. /etc/os-release
echo "distribution=$ID version=$VERSION_ID codename=$VERSION_CODENAME"
dpkg --print-architecture

Ce que fait chaque partie

1. . /etc/os-release charge les informations système dans le shell.
2. echo affiche les trois valeurs utiles sans modifier la VM.
3. dpkg --print-architecture affiche par exemple amd64 ou arm64.

Résultat attendu

distribution=debian apparaît avec une version, un codename et une architecture.

Si cela échoue

Si ID n’est pas debian, n’ajoute pas le dépôt Debian : suis la documentation Docker de ta distribution.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

ID vaut debian pour suivre la suite telle quelle.VERSION_CODENAME n’est pas vide.Je connais l’architecture de la VM.

Question de soutenance — Engine et Compose sont-ils la même chose ?

Non. Engine construit et exécute les objets Docker ; Compose lit un plan qui orchestre plusieurs services.

Étape 6 — Mettre APT à jour

Objectif. Tu prépareras le gestionnaire de paquets avant d’ajouter Docker.

État du projet avant cette étape. Debian est identifié, mais sa liste locale de paquets peut être ancienne.

Comprendre le changement

apt update télécharge la liste actuelle des paquets. ca-certificates permet de vérifier HTTPS ; curl téléchargera la clé Docker ; git et make serviront au projet.

Repère pédagogique · Docker Docs

Bonne pratique : préparation issue de la procédure officielle Docker pour Debian ; ce détail n’est pas imposé par le PDF.

Faire une seule chose

Actualise APT puis installe uniquement les outils de base. Aucun composant Docker n’est installé à cette étape.

À EXÉCUTER DANSDans la VM · n’importe quel dossier

Copier

sudo apt update
sudo apt install -y ca-certificates curl git make

Ce que fait chaque partie

1. sudo exécute la commande avec les droits administrateur.
2. apt update actualise le catalogue.
3. apt install ajoute les quatre outils.
4. -y accepte la confirmation d’installation.

Résultat attendu

APT termine sans erreur et indique les paquets installés ou déjà à jour.

Si cela échoue

Une erreur Temporary failure resolving signale le réseau de la VM, pas Docker.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

apt update termine sans erreur.curl --version affiche une version.git --version et make --version fonctionnent.

Question de soutenance — Engine et Compose sont-ils la même chose ?

Non. Engine construit et exécute les objets Docker ; Compose lit un plan qui orchestre plusieurs services.

Étape 7 — Retirer les paquets Docker conflictuels

Objectif. Tu éviteras de mélanger les paquets Debian et le dépôt officiel Docker.

État du projet avant cette étape. Les outils de base sont installés. Docker ne l’est pas encore depuis sa source officielle.

Comprendre le changement

Debian peut fournir docker.io ou une ancienne commande docker-compose. Docker recommande de retirer ces paquets avant d’installer docker-ce et le plugin Compose.

Repère pédagogique · Docker Docs

Bonne pratique issue de la procédure Docker officielle ; le sujet exige Docker Compose mais ne prescrit pas les noms de paquets.

Faire une seule chose

Lance la commande officielle. Sur une VM neuve, APT peut simplement indiquer qu’aucun de ces paquets n’est installé : c’est un résultat normal.

À EXÉCUTER DANSDans la VM · n’importe quel dossier

Copier

conflicts=$(dpkg-query -W -f='${binary:Package}\n' docker.io docker-compose docker-doc docker-buildx podman-docker containerd runc 2>/dev/null)
if [ -n "$conflicts" ]; then
  sudo apt remove -y $conflicts
else
  echo "Aucun paquet conflictuel installé"
fi

Ce que fait chaque partie

1. dpkg-query recherche uniquement les paquets réellement installés.
2. conflicts mémorise leurs noms sans modifier la VM.
3. Le if lance apt remove seulement si la liste n’est pas vide.
4. Cette étape évite que deux installations gèrent les mêmes binaires ou le même runtime.

Résultat attendu

APT retire les éventuels conflits ou affiche Aucun paquet conflictuel installé.

Si cela échoue

Si apt refuse une suppression à cause de dépendances, lis la liste proposée avant de confirmer une autre action.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

Aucune ancienne commande docker-compose n’est volontairement conservée.Je comprends que docker compose est le plugin moderne attendu.La commande n’a pas supprimé les outils Git ou make.

Question de soutenance — Engine et Compose sont-ils la même chose ?

Non. Engine construit et exécute les objets Docker ; Compose lit un plan qui orchestre plusieurs services.

Étape 8 — Installer la clé du dépôt Docker

Objectif. APT pourra vérifier que les paquets viennent bien de Docker.

État du projet avant cette étape. APT est propre, mais il ne connaît pas encore le dépôt Docker.

Comprendre le changement

Une clé GPG permet à APT de vérifier la signature des métadonnées téléchargées. Elle ne donne aucun accès à ton compte et ce n’est pas un mot de passe.

Repère pédagogique · Docker Docs

Bonne pratique : commandes de la documentation officielle Docker Engine pour Debian.

Faire une seule chose

Crée le dossier des clés, télécharge la clé officielle puis rends-la lisible par APT.

Fichiers ou emplacements concernés

• /etc/apt/keyrings/docker.asc

À EXÉCUTER DANSDans la VM · n’importe quel dossier

Copier

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
ls -l /etc/apt/keyrings/docker.asc

Ce que fait chaque partie

1. install -d crée le dossier avec le mode 0755.
2. curl -fsSL télécharge la clé et échoue proprement en cas d’erreur HTTP.
3. -o choisit le fichier de destination.
4. chmod a+r autorise APT à lire la clé.
5. ls confirme l’existence et les permissions.

Résultat attendu

docker.asc existe, n’est pas vide et est lisible.

Si cela échoue

Si curl échoue, vérifie la date de la VM, sa connexion réseau et l’URL exacte.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

/etc/apt/keyrings/docker.asc existe.Le fichier n’est pas vide.Je peux expliquer qu’il sert à vérifier des signatures.

Question de soutenance — Engine et Compose sont-ils la même chose ?

Non. Engine construit et exécute les objets Docker ; Compose lit un plan qui orchestre plusieurs services.

Étape 9 — Ajouter le dépôt Docker

Objectif. APT saura maintenant où trouver Engine et Compose.

État du projet avant cette étape. La clé officielle est installée, mais aucune source APT ne l’utilise encore.

Comprendre le changement

Le fichier docker.sources relie l’URL Docker, le codename Debian, l’architecture et la clé de signature. Les valeurs sont lues depuis la VM pour éviter de les deviner.

Repère pédagogique · Docker Docs

Bonne pratique : configuration officielle du dépôt Docker pour Debian.

Faire une seule chose

Crée le fichier exactement comme ci-dessous, puis affiche-le avant d’actualiser APT.

Fichiers ou emplacements concernés

• /etc/apt/sources.list.d/docker.sources

À EXÉCUTER DANSDans la VM · n’importe quel dossier

Copier

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
cat /etc/apt/sources.list.d/docker.sources

Ce que fait chaque partie

1. tee écrit le fichier avec les droits sudo.
2. Suites prend le codename réel de Debian.
3. Architectures reprend l’architecture vérifiée.
4. Signed-By associe ce dépôt à la clé Docker.
5. cat permet de relire le résultat avant utilisation.

Résultat attendu

Le fichier contient six lignes cohérentes, dont le codename de ta VM.

Si cela échoue

Un champ Suites vide signifie que VERSION_CODENAME n’a pas été lu : corrige avant apt update.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

docker.sources existe.Suites contient le codename Debian réel.Signed-By pointe vers docker.asc.

Question de soutenance — Engine et Compose sont-ils la même chose ?

Non. Engine construit et exécute les objets Docker ; Compose lit un plan qui orchestre plusieurs services.

Étape 10 — Installer Engine, Buildx et Compose

Objectif. Tu installeras enfin les cinq composants Docker nécessaires.

État du projet avant cette étape. APT connaît le dépôt officiel et sa clé.

Comprendre le changement

docker-ce est le moteur, docker-ce-cli est la commande, containerd.io exécute les containers, buildx construit les images et docker-compose-plugin fournit docker compose.

Repère pédagogique · p. 6

Le sujet exige Docker Compose. Le choix de l’installation officielle est une recommandation du guide.

Faire une seule chose

Actualise APT une dernière fois puis installe les cinq paquets ensemble.

À EXÉCUTER DANSDans la VM · n’importe quel dossier

Copier

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

Ce que fait chaque partie

1. Le premier apt update charge le nouveau dépôt.
2. docker-ce installe le daemon Docker Engine.
3. docker-ce-cli installe la commande docker.
4. containerd.io fournit le runtime.
5. buildx et compose ajoutent les deux plugins CLI.

Résultat attendu

Les cinq paquets sont installés sans erreur.

Si cela échoue

NO_PUBKEY signale un problème de clé ; Package has no installation candidate signale souvent un mauvais codename ou dépôt.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

docker-ce est installé.docker-buildx-plugin est installé.docker-compose-plugin est installé.

Question de soutenance — Engine et Compose sont-ils la même chose ?

Non. Engine construit et exécute les objets Docker ; Compose lit un plan qui orchestre plusieurs services.

Étape 11 — Démarrer le daemon Docker

Objectif. Tu distingueras une commande installée d’un moteur réellement actif.

État du projet avant cette étape. Les paquets sont présents. Le daemon peut toutefois être arrêté.

Comprendre le changement

La commande docker est un client. Elle parle au daemon dockerd, géré ici par systemd. enable prépare les prochains démarrages ; –now démarre immédiatement.

Repère pédagogique · p. 5

Bonne pratique d’exploitation ; le PDF exige une infrastructure fonctionnelle dans la VM.

Faire une seule chose

Active Docker, puis demande à systemd un résultat binaire et lis les premières lignes de docker info avec sudo.

À EXÉCUTER DANSDans la VM · n’importe quel dossier

Copier

sudo systemctl enable --now docker
sudo systemctl is-active docker
sudo docker info | sed -n '1,20p'

Ce que fait chaque partie

1. systemctl enable prépare le démarrage automatique.
2. --now démarre le service sans attendre un reboot.
3. is-active doit répondre active.
4. docker info contacte réellement le daemon.

Résultat attendu

is-active affiche active et docker info contient une section Server.

Si cela échoue

Si le service est failed, lance sudo journalctl -u docker --no-pager -n 50 et lis la première erreur.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

systemctl is-active docker affiche active.docker info affiche une section Server.Je distingue la CLI docker du daemon dockerd.

Question de soutenance — Engine et Compose sont-ils la même chose ?

Non. Engine construit et exécute les objets Docker ; Compose lit un plan qui orchestre plusieurs services.

Étape 12 — Autoriser ton utilisateur à lancer Docker

Objectif. Tu éviteras de préfixer toutes les commandes du projet par sudo.

État du projet avant cette étape. Docker fonctionne avec sudo. Ton utilisateur ordinaire n’a peut-être pas encore accès au socket du daemon.

Comprendre le changement

Le groupe docker donne accès au socket Docker. Cette permission équivaut pratiquement à des droits administrateur sur la VM : elle doit rester limitée à ton utilisateur.

Repère pédagogique · Docker Docs

Bonne pratique Docker post-install ; le sujet ne prescrit pas cette permission utilisateur.

Faire une seule chose

Ajoute ton utilisateur au groupe, ferme complètement sa session terminal puis reconnecte-toi dans la VM. Vérifie ensuite les groupes sans sudo.

À EXÉCUTER DANSDans la VM · n’importe quel dossier

Copier

sudo usermod -aG docker "$USER"

Ce que fait chaque partie

1. usermod modifie les groupes de l’utilisateur.
2. -aG ajoute docker sans retirer les autres groupes.
3. $USER désigne l’utilisateur connecté.

Résultat attendu

La commande ne produit normalement aucune sortie.

Si cela échoue

Ne lance pas chmod 777 sur /var/run/docker.sock : reconnecte-toi après avoir ajouté le groupe.

À EXÉCUTER DANSDans un nouveau terminal de la VM après reconnexion

Copier

id -nG
docker info >/dev/null && echo "daemon accessible sans sudo"

Ce que fait chaque partie

1. id -nG affiche les groupes actifs de cette nouvelle session.
2. docker info sans sudo prouve l’accès au daemon.
3. && affiche le message seulement si Docker répond.

Résultat attendu

docker apparaît dans les groupes et le message de confirmation s’affiche.

Si cela échoue

Si docker manque dans id -nG, la session n’a pas réellement été recréée ; déconnecte puis reconnecte l’utilisateur.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

id -nG contient docker.docker info fonctionne sans sudo.Je comprends que le groupe docker accorde des privilèges élevés.

Question de soutenance — Engine et Compose sont-ils la même chose ?

Non. Engine construit et exécute les objets Docker ; Compose lit un plan qui orchestre plusieurs services.

Étape 13 — Vérifier les trois outils

Objectif. Tu prouveras Engine, Buildx et Compose séparément.

État du projet avant cette étape. Le daemon répond sans sudo.

Comprendre le changement

docker version teste client et serveur. docker buildx version teste le constructeur. docker compose version teste l’orchestrateur qui sera utilisé par Inception.

Exigence du sujet · p. 6

Exigence du sujet : Docker Compose sera utilisé pour toute l’infrastructure.

Faire une seule chose

Lance les trois commandes. Ne continue pas si l’une d’elles est absente.

À EXÉCUTER DANSDans la VM · n’importe quel dossier

Copier

docker version
docker buildx version
docker compose version

Ce que fait chaque partie

1. docker version affiche une partie Client et une partie Server.
2. docker buildx version vérifie le plugin de build.
3. docker compose version vérifie la syntaxe moderne avec un espace.

Résultat attendu

Les trois commandes affichent une version et aucune permission denied.

Si cela échoue

Si docker-compose avec un tiret existe mais docker compose échoue, le plugin docker-compose-plugin manque.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

docker version affiche Client et Server.docker buildx version fonctionne.docker compose version fonctionne avec un espace.

Question de soutenance — Engine et Compose sont-ils la même chose ?

Non. Engine construit et exécute les objets Docker ; Compose lit un plan qui orchestre plusieurs services.