Installer Docker Engine depuis les binaires

Important

Cette page contient des informations sur comment installer Docker en utilisant des binaires. Ces instructions sont principalement adaptées à des fins de test. Nous ne recommandons pas d'installer Docker en utilisant des binaires dans des environnements de production car ils n'ont pas de mises à jour de sécurité automatiques. Les binaires Linux décrits sur cette page sont liés statiquement, ce qui signifie que les vulnérabilités dans les dépendances de build-time ne sont pas automatiquement corrigées par les mises à jour de sécurité de votre distribution Linux.

Mettre à jour les binaires est également légèrement plus complexe comparé aux paquets Docker installés en utilisant un gestionnaire de paquets ou via Docker Desktop, car cela nécessite de mettre à jour (manuellement) la version installée chaque fois qu'il y a une nouvelle version de Docker.

De plus, les binaires statiques peuvent ne pas inclure toutes les fonctionnalités fournies par les paquets dynamiques.

Sur Windows et Mac, nous recommandons d'installer Docker Desktop à la place. Pour Linux, nous recommandons de suivre les instructions spécifiques à votre distribution.

Si vous voulez essayer Docker ou l'utiliser dans un environnement de test, mais vous n'êtes pas sur une plateforme supportée, vous pouvez essayer d'installer depuis des binaires statiques. Si possible, vous devriez utiliser des paquets construits pour votre système d'exploitation, et utiliser le système de gestion de paquets de votre système d'exploitation pour gérer l'installation et les mises à niveau de Docker.

Les binaires statiques pour le binaire du daemon Docker ne sont disponibles que pour Linux (comme dockerd) et Windows (comme dockerd.exe). Les binaires statiques pour le client Docker sont disponibles pour Linux, Windows et macOS (comme docker).

Ce sujet traite de l'installation binaire pour Linux, Windows et macOS :

• Installer les binaires daemon et client sur Linux
• Installer les binaires client sur macOS
• Installer les binaires serveur et client sur Windows

Installer les binaires daemon et client sur Linux

Prérequis

Avant de tenter d'installer Docker depuis des binaires, assurez-vous que votre machine hôte répond aux prérequis :

• Une installation 64-bit
• Version 3.10 ou supérieure du noyau Linux. La dernière version du noyau disponible pour votre plateforme est recommandée.
• iptables version 1.4 ou supérieure
• git version 1.7 ou supérieure
• Un exécutable ps, généralement fourni par procps ou un paquet similaire.
• XZ Utils 4.9 ou supérieur
• Une hiérarchie cgroupfs correctement montée ; un point de montage cgroup unique et global n'est pas suffisant. Voir les problèmes Github #2683, #3485, #4568).

Sécurisez votre environnement autant que possible

Considérations du système d'exploitation

Activez SELinux ou AppArmor si possible.

Il est recommandé d'utiliser AppArmor ou SELinux si votre distribution Linux supporte l'un des deux. Cela aide à améliorer la sécurité et bloque certains types d'exploits. Consultez la documentation de votre distribution Linux pour les instructions d'activation et de configuration d'AppArmor ou SELinux.

Avertissement de sécurité

Si l'un des mécanismes de sécurité est activé, ne le désactivez pas comme solution de contournement pour faire fonctionner Docker ou ses conteneurs. À la place, configurez-le correctement pour corriger tous les problèmes.

Considérations du daemon Docker

• Activez les profils de sécurité seccomp si possible. Voir Activer seccomp pour Docker.

• Activez les espaces de noms utilisateur si possible. Voir les Options d'espace de noms utilisateur du daemon.

Installer les binaires statiques

1. Téléchargez l'archive binaire statique. Allez à https://download.docker.com/linux/static/stable/, choisissez votre plateforme matérielle, et téléchargez le fichier .tgz relatif à la version de Docker Engine que vous voulez installer.

2. Extrayez l'archive en utilisant l'utilitaire tar. Les binaires dockerd et docker sont extraits.

   $ tar xzvf /path/to/<FILE>.tar.gz
   

3. Optionnel : Déplacez les binaires vers un répertoire sur votre chemin d'exécutable, tel que /usr/bin/. Si vous ignorez cette étape, vous devez fournir le chemin vers l'exécutable quand vous invoquez les commandes docker ou dockerd.

   $ sudo cp docker/* /usr/bin/
   

4. Démarrez le daemon Docker :

   $ sudo dockerd &
   

   Si vous avez besoin de démarrer le daemon avec des options supplémentaires, modifiez la commande ci-dessus en conséquence ou créez et éditez le fichier /etc/docker/daemon.json pour ajouter les options de configuration personnalisées.

5. Vérifiez que Docker est installé correctement en exécutant l'image hello-world.

   $ sudo docker run hello-world
   

   Cette commande télécharge une image de test et l'exécute dans un conteneur. Quand le conteneur s'exécute, il affiche un message et se ferme.

Vous avez maintenant installé et démarré Docker Engine avec succès.

Tip

Vous recevez des erreurs lorsque vous essayez d'exécuter sans root ?

Le groupe d'utilisateurs docker existe mais ne contient aucun utilisateur, c'est pourquoi vous devez utiliser sudo pour exécuter les commandes Docker. Continuez vers Post-installation Linux pour autoriser les utilisateurs non privilégiés à exécuter les commandes Docker et pour d'autres étapes de configuration facultatives.

Installer les binaires client sur macOS

Note

Les instructions suivantes sont principalement adaptées à des fins de test. Le binaire macOS inclut seulement le client Docker. Il n'inclut pas le daemon dockerd qui est requis pour exécuter des conteneurs. Par conséquent, nous recommandons d'installer Docker Desktop à la place.

Les binaires pour Mac ne contiennent pas non plus :

• Un environnement d'exécution. Vous devez configurer un moteur fonctionnel soit dans une machine virtuelle, soit sur une machine Linux distante.
• Les composants Docker tels que buildx et docker compose.

Pour installer les binaires client, effectuez les étapes suivantes :

1. Téléchargez l'archive binaire statique. Allez à https://download.docker.com/mac/static/stable/ et sélectionnez x86_64 (pour Mac sur puce Intel) ou aarch64 (pour Mac sur puce Apple silicon), puis téléchargez le fichier .tgz relatif à la version de Docker Engine que vous voulez installer.

2. Extrayez l'archive en utilisant l'utilitaire tar. Le binaire docker est extrait.

   $ tar xzvf /path/to/<FILE>.tar.gz
   

3. Effacez les attributs étendus pour lui permettre de s'exécuter.

   $ sudo xattr -rc docker
   

   Maintenant, quand vous exécutez la commande suivante, vous pouvez voir les instructions d'utilisation du CLI Docker :

   $ docker/docker
   

4. Optionnel : Déplacez le binaire vers un répertoire sur votre chemin d'exécutable, tel que /usr/local/bin/. Si vous ignorez cette étape, vous devez fournir le chemin vers l'exécutable quand vous invoquez les commandes docker ou dockerd.

   $ sudo cp docker/docker /usr/local/bin/
   

5. Vérifiez que Docker est installé correctement en exécutant l'image hello-world. La valeur de <hostname> est un nom d'hôte ou une adresse IP exécutant le daemon Docker et accessible au client.

   $ sudo docker -H <hostname> run hello-world
   

   Cette commande télécharge une image de test et l'exécute dans un conteneur. Quand le conteneur s'exécute, il affiche un message et se ferme.

Installer les binaires serveur et client sur Windows

Ce répertoire de téléchargement contient seulement les binaires pour les versions de Docker qui sont aussi disponibles dans Docker Desktop pour Windows. Le daemon Docker pour Windows nécessite Windows Server 2016 ou Windows 10, et la version Windows de Docker ne fonctionne que sur Windows.

Note

Les instructions suivantes sont principalement adaptées à des fins de test. Windows nécessite Windows Server 2016 ou Windows 10 pour exécuter des conteneurs Windows, et Docker Desktop est le meilleur moyen de commencer avec des conteneurs sur Windows. Pour plus d'informations, voir Docker Desktop.

Prérequis

• Windows Server 2016, Windows 10

Si vous êtes sur Windows 10, vous devez avoir la Update anniversaire (build 14393) ou plus récent.

Installer les binaires statiques

1. Téléchargez l'archive zip statique. Allez à https://download.docker.com/win/static/stable/x86_64/ et téléchargez le fichier .zip relatif à la version de Docker Engine que vous voulez installer.

2. Extrayez l'archive et copiez les binaires vers un répertoire dans votre PATH.

3. Démarrez le daemon Docker :

   PS C:\> dockerd --register-service
   PS C:\> Start-Service docker

4. Vérifiez que Docker est installé correctement en exécutant l'image hello-world.

   PS C:\> docker run hello-world:nanoserver

   Cette commande télécharge une image de test et l'exécute dans un conteneur. Quand le conteneur s'exécute, il affiche un message et se ferme.

Mettre à niveau Docker après installation binaire

Si vous avez installé Docker depuis des binaires, suivez ces étapes pour mettre à niveau :

1. Arrêtez docker : sudo killall dockerd
2. Téléchargez la version plus récente selon les étapes ci-dessus.
3. Répétez l'étape d'installation de copie des binaires.
4. Redémarrez docker.

Prochaines étapes

• Continuez vers Étapes post-installation pour Linux.