Aperçu de la configuration du démon Docker
Cette page vous montre comment personnaliser le démon Docker, dockerd
.
NoteCette 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 :