Configurer la Gestion des Paramètres avec un fichier JSON

Cette page explique comment utiliser un fichier admin-settings.json pour configurer et appliquer les paramètres Docker Desktop. Utilisez cette méthode pour standardiser les environnements Docker Desktop dans votre organisation.

Prérequis

• Forcer la connexion pour s'assurer que tous les utilisateurs s'authentifient auprès de votre organisation.
• Un abonnement Docker Business est requis.

Docker Desktop applique uniquement les paramètres du fichier admin-settings.json si les vérifications d'authentification et de licence Docker Business réussissent.

Important

Si un utilisateur n'est pas connecté ou ne fait pas partie d'une organisation Docker Business, le fichier de paramètres est ignoré.

Limitation

• Le fichier admin-settings.json ne fonctionne pas dans les environnements isolés ou hors ligne.
• Le fichier n'est pas compatible avec les environnements qui restreignent l'authentification avec Docker Hub.

Étape un : Créer le fichier de paramètres

Vous pouvez :

• Utiliser le flag d'installation --admin-settings pour générer automatiquement le fichier. Voir :
  • Guide d'installation macOS
  • Guide d'installation Windows
• Ou le créer manuellement et le placer dans les emplacements suivants :
  • Mac : /Library/Application\ Support/com.docker.docker/admin-settings.json
  • Windows : C:\ProgramData\DockerDesktop\admin-settings.json
  • Linux : /usr/share/docker-desktop/admin-settings.json

Important

Placez le fichier dans un répertoire protégé pour empêcher les modifications. Utilisez des outils MDM comme Jamf pour le distribuer à grande échelle.

Étape deux : Définir les paramètres

Tip

Pour une liste complète des paramètres disponibles, leurs plateformes supportées, et avec quelles méthodes de configuration ils fonctionnent, voir la Référence des paramètres.

Le fichier admin-settings.json utilise des clés structurées pour définir ce qui peut être configuré et si les valeurs sont appliquées.

Chaque paramètre supporte le champ locked. Quand locked est défini sur true, les utilisateurs ne peuvent pas changer cette valeur dans Docker Desktop, le CLI, ou les fichiers de configuration. Quand locked est défini sur false, la valeur agit comme une suggestion par défaut et les utilisateurs peuvent toujours la mettre à jour.

Les paramètres où locked est défini sur false sont ignorés sur les installations existantes si un utilisateur a déjà personnalisé cette valeur dans settings-store.json, settings.json, ou daemon.json.

Note

Certains paramètres sont spécifiques à la plateforme ou nécessitent une version minimale de Docker Desktop. Voir la Référence des paramètres pour les détails.

Exemple de fichier de paramètres

Le fichier suivant est un exemple de fichier admin-settings.json. Pour une liste complète des paramètres configurables pour le fichier admin-settings.json, voir Configurations admin-settings.json.

{
  "configurationFileVersion": 2,
  "exposeDockerAPIOnTCP2375": {
    "locked": true,
    "value": false
  },
  "proxy": {
    "locked": true,
    "mode": "system",
    "http": "",
    "https": "",
    "exclude": [],
    "windowsDockerdPort": 65000,
    "enableKerberosNtlm": false
  },
  "containersProxy": {
    "locked": true,
    "mode": "manual",
    "http": "",
    "https": "",
    "exclude": [],
    "pac":"",
    "transparentPorts": ""
  },
  "enhancedContainerIsolation": {
    "locked": true,
    "value": true,
    "dockerSocketMount": {
      "imageList": {
        "images": [
          "docker.io/localstack/localstack:*",
          "docker.io/testcontainers/ryuk:*"
        ]
      },
      "commandList": {
        "type": "deny",
        "commands": ["push"]
      }
    }
  },
  "linuxVM": {
    "wslEngineEnabled": {
      "locked": false,
      "value": false
    },
    "dockerDaemonOptions": {
      "locked": false,
      "value":"{\"debug\": false}"
    },
    "vpnkitCIDR": {
      "locked": false,
      "value":"192.168.65.0/24"
    }
  },
  "kubernetes": {
     "locked": false,
     "enabled": false,
     "showSystemContainers": false,
     "imagesRepository": ""
  },
  "windowsContainers": {
    "dockerDaemonOptions": {
      "locked": false,
      "value":"{\"debug\": false}"
    }
  },
  "disableUpdate": {
    "locked": false,
    "value": false
  },
  "analyticsEnabled": {
    "locked": false,
    "value": true
  },
  "extensionsEnabled": {
    "locked": true,
    "value": false
  },
  "scout": {
    "locked": false,
    "sbomIndexing": true,
    "useBackgroundIndexing": true
  },
  "allowBetaFeatures": {
    "locked": false,
    "value": false
  },
  "blockDockerLoad": {
    "locked": false,
    "value": true
  },
  "filesharingAllowedDirectories": [
    {
      "path": "$HOME",
      "sharedByDefault": true
    },
    {
      "path":"$TMP",
      "sharedByDefault": false
    }
  ],
  "useVirtualizationFrameworkVirtioFS": {
    "locked": true,
    "value": true
  },
  "useVirtualizationFrameworkRosetta": {
    "locked": true,
    "value": true
  },
  "useGrpcfuse": {
    "locked": true,
    "value": true
  },
  "displayedOnboarding": {
    "locked": true,
    "value": true
  },
  "desktopTerminalEnabled": {
    "locked": false,
    "value": false
  }
}

Étape trois : Redémarrer et appliquer les paramètres

Les paramètres s'appliquent après le redémarrage de Docker Desktop et la connexion de l'utilisateur.

• Nouvelles installations : Lancez Docker Desktop et connectez-vous.
• Installations existantes : Quittez complètement Docker Desktop et relancez-le.

Important

Redémarrer Docker Desktop depuis le menu n'est pas suffisant. Il doit être complètement quitté et rouvert.

Configurations admin-settings.json

Général

Partage de fichiers et émulation

Docker Scout

Proxy

Proxy de conteneurs

VM Linux

Conteneurs Windows

Note

Ce paramètre n'est pas disponible pour la configuration via la Console d'Administration Docker.

Kubernetes

Note

Lors de l'utilisation du paramètre imagesRepository et de l'Isolation de Conteneurs Renforcée (ECI), ajoutez les images suivantes à la liste d'images de montage de socket Docker ECI :

• [imagesRepository]/desktop-cloud-provider-kind:*
• [imagesRepository]/desktop-containerd-registry-mirror:*

Ces conteneurs montent le socket Docker, donc vous devez ajouter les images à la liste d'images ECI. Sinon, ECI bloquera le montage et Kubernetes ne démarrera pas.

Réseau

Pour plus d'informations, voir Réseau.

Fonctionnalités bêta

Important

Pour Docker Desktop versions 4.41 et antérieures, certains de ces paramètres se trouvaient sous l'onglet Fonctionnalités expérimentales de la page Fonctionnalités en développement.

Isolation de Conteneurs Renforcée