Aller au contenu principal

Installer Docker Engine sur Ubuntu

Avertissement : N'utilisez jamais apt pour installer Docker sur Ubuntu. Suivez toujours les instructions ci-dessous pour configurer correctement le dépôt APT Docker avant d'essayer d'installer Docker.

Prérequis​

Exigences du système d'exploitation​

Docker prend en charge les versions suivantes d'Ubuntu :

  • Ubuntu Mantic 23.10
  • Ubuntu Jammy 22.04 (LTS)
  • Ubuntu Focal 20.04 (LTS)

Docker peut être installé sur des plates-formes x86 64 bits ou ARM. Les versions LTS (Long Term Support) d'Ubuntu sont recommandées pour les environnements de production, car elles bénéficient de 5 ans de mises à jour de sécurité.

Désinstaller les anciennes versions​

Les anciennes versions de Docker s'appelaient docker ou docker-engine. Si elles sont installées, désinstallez-les d'abord :

$ for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker; do sudo apt-get remove $pkg; done

De plus, Docker Engine dépend de containerd et runc. Désinstallez-les également pour éviter les conflits :

$ sudo apt-get remove containerd runc

Installer en utilisant le dépôt APT​

Configurer le dépôt APT Docker​

Mettez à jour l'index des paquets apt et installez les paquets pour permettre à apt d'utiliser un dépôt via HTTPS :

# Ajouter la clé GPG officielle de Docker :
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc 
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Ajouter le dépôt aux sources Apt :
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Si vous utilisez une distribution dérivée d'Ubuntu, comme Linux Mint, vous devrez peut-être utiliser UBUNTU_CODENAME au lieu de VERSION_CODENAME.

Installer les paquets Docker​

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

Installer en utilisant le script pratique​

Docker fournit un script pratique pour simplifier le processus d'installation pour les environnements de test et de développement. Sur Ubuntu, vous pouvez utiliser ce script et éventuellement utiliser le drapeau --mirror pour installer à partir d'un dépôt miroir :

# $ curl -fsSL test.docker.com -o get-docker.sh
$ curl -fsSL get.docker.com -o get-docker.sh  
$ sudo sh get-docker.sh --mirror Aliyun
# $ sudo sh get-docker.sh --mirror AzureChinaCloud

Ce script gérera automatiquement tous les prérequis et installera la dernière version stable de Docker.

Démarrer Docker​

$ sudo systemctl enable docker
$ sudo systemctl start docker

Gérer Docker en tant qu'utilisateur non-root​

Par défaut, la commande docker utilise le socket Unix pour communiquer avec le moteur Docker. Seul root et les utilisateurs du groupe docker peuvent accéder au socket Unix.

Pour éviter d'utiliser root, créez un groupe docker et ajoutez-y votre utilisateur :

$ sudo groupadd docker
$ sudo usermod -aG docker $USER

Déconnectez-vous et reconnectez-vous pour que les modifications prennent effet.

Tester l'installation de Docker​

$ docker run --rm hello-world

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
b8dfde127a29: Pull complete  
Digest: sha256:308866a43596e83578c7dfa15e27a73011bdd402185a84c5cd7f32a88b501a24
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

...

Si vous voyez la sortie ci-dessus, Docker est correctement installé.

Références​