⚠️ Traduction non officielle - Cette documentation est une traduction communautaire non officielle de Docker.

Aperçu de la configuration du démon Docker

Cette page vous montre comment personnaliser le démon Docker, dockerd.

Note

Cette page est pour les utilisateurs qui ont installé Docker Engine manuellement. Si vous utilisez Docker Desktop, référez-vous à la page des paramètres.

Configurer le démon Docker

Il y a deux façons de configurer le démon Docker :

  • Utiliser un fichier de configuration JSON. C'est l'option préférée, car elle garde toutes les configurations dans un seul endroit.
  • Utiliser des drapeaux lors du démarrage de dockerd.

Vous pouvez utiliser ces deux options ensemble tant que vous ne spécifiez pas la même option à la fois comme drapeau et dans le fichier JSON. Si cela arrive, le démon Docker ne démarrera pas et affichera un message d'erreur.

Fichier de configuration

Le tableau suivant montre l'emplacement où le démon Docker s'attend à trouver le fichier de configuration par défaut, selon votre système et comment vous exécutez le démon.

OS et configuration Emplacement du fichier
Linux, installation standard /etc/docker/daemon.json
Linux, mode rootless ~/.config/docker/daemon.json
Windows C:\ProgramData\docker\config\daemon.json

Pour le mode rootless, le démon respecte la variable XDG_CONFIG_HOME. Si définie, l'emplacement attendu du fichier est $XDG_CONFIG_HOME/docker/daemon.json.

Vous pouvez également spécifier explicitement l'emplacement du fichier de configuration au démarrage, en utilisant le drapeau dockerd --config-file.

Apprenez les options de configuration disponibles dans la documentation de référence dockerd

Configuration utilisant des drapeaux

Vous pouvez aussi démarrer le démon Docker manuellement et le configurer en utilisant des drapeaux. Ceci peut être utile pour dépanner des problèmes.

Voici un exemple de comment démarrer manuellement le démon Docker, en utilisant les mêmes configurations que celles montrées dans la configuration JSON précédente :

$ dockerd --debug \
  --tls=true \
  --tlscert=/var/docker/server.pem \
  --tlskey=/var/docker/serverkey.pem \
  --host tcp://192.168.59.3:2376

Apprenez les options de configuration disponibles dans la documentation de référence dockerd, ou en exécutant :

$ dockerd --help

Répertoire de données du démon

Le démon Docker persiste toutes les données dans un seul répertoire. Ceci suit tout ce qui est lié à Docker, incluant les conteneurs, images, volumes, définition de service, et secrets.

Par défaut ce répertoire est :

  • /var/lib/docker sur Linux.
  • C:\ProgramData\docker sur Windows.

Vous pouvez configurer le démon Docker pour utiliser un répertoire différent, en utilisant l' option de configuration data-root. Par exemple :

{
  "data-root": "/mnt/docker-data"
}

Puisque l'état d'un démon Docker est gardé dans ce répertoire, assurez-vous d'utiliser un répertoire dédié pour chaque démon. Si deux démons partagent le même répertoire, par exemple, un partage NFS, vous allez rencontrer des erreurs difficiles à dépanner.

Prochaines étapes

De nombreuses options de configuration spécifiques sont discutées à travers la documentation Docker. Quelques endroits où aller ensuite incluent :