Configurar la Gestión de Ajustes con un archivo JSON

La Gestión de Ajustes (Settings Management) te permite configurar e imponer los ajustes de Docker Desktop en toda tu organización utilizando un archivo admin-settings.json. Esto estandariza los entornos de Docker Desktop y garantiza configuraciones consistentes para todos los usuarios.

Requisitos previos

Antes de comenzar, asegúrate de tener:

• La imposición del inicio de sesión habilitada para tu organización.
• Una suscripción de Docker Business.

La presencia del archivo admin-settings.json impone el inicio de sesión en Docker Desktop. Esto está diseñado para características empresariales que requieren autenticación.

Los usuarios deben iniciar sesión y formar parte de una organización de Docker Business. Si no se cumple alguna de estas condiciones, se ignora el archivo de configuración.

Paso uno: Crear el archivo de ajustes

Puedes crear el archivo admin-settings.json de dos maneras:

• Utiliza la bandera del instalador --admin-settings para generar automáticamente el archivo:
  • Guía de instalación de Mac
  • Guía de instalación de Windows
• Créalo manualmente (UTF-8 sin BOM) y colócalo en las siguientes ubicaciones:
  • 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

Coloca el archivo en un directorio protegido para evitar cambios no autorizados. Utiliza herramientas de Gestión de Dispositivos Móviles (MDM) como Jamf para distribuir el archivo a escala en toda tu organización.

Paso dos: Configurar los ajustes

Tip

Para obtener una lista completa de los ajustes disponibles, las plataformas admitidas y los métodos de configuración compatibles, consulta la Referencia de ajustes.

El archivo admin-settings.json utiliza claves estructuradas para definir los ajustes configurables y si los valores están impuestos.

Cada ajuste admite un campo locked (bloqueado) que controla los permisos del usuario:

• Cuando locked se establece en true, los usuarios no pueden cambiar ese valor en Docker Desktop, la CLI o los archivos de configuración.
• Cuando locked se establece en false, el valor actúa como una sugerencia predeterminada y los usuarios pueden actualizarlo.

Los ajustes donde locked se establece en false se ignoran en las instalaciones existentes si el usuario ya ha personalizado ese valor en settings-store.json, settings.json o daemon.json.

Ajustes agrupados

Docker Desktop agrupa algunos ajustes con un único interruptor (toggle) que controla la sección completa. Estos incluyen:

• Aislamiento de Contenedores Mejorado (ECI): Utiliza un interruptor principal (enhancedContainerIsolation) que habilita/deshabilita toda la característica, con subajustes para configuraciones específicas.
• Kubernetes: Utiliza un interruptor principal (kubernetes.enabled) con subajustes para la configuración del clúster.
• Docker Scout: Agrupa los ajustes bajo el objeto scout.

Al configurar los ajustes agrupados:

1. Establece el interruptor principal para habilitar la característica.
2. Configura los subajustes dentro de ese grupo.
3. Cuando bloqueas el interruptor principal, los usuarios no pueden modificar ningún ajuste en ese grupo.

Ejemplo para enhancedContainerIsolation:

"enhancedContainerIsolation": {
  "locked": true,  // Esto bloquea toda la sección de ECI
  "value": true,   // Esto habilita ECI
  "dockerSocketMount": {  // Estos son subajustes
    "imageList": {
      "images": ["docker.io/testcontainers/ryuk:*"]
    }
  }
}

Ejemplo de archivo admin-settings.json

La siguiente muestra es un archivo admin-settings.json con los ajustes empresariales comunes configurados. Puedes utilizar este ejemplo como plantilla con las configuraciones de admin-settings.json:

{
  "configurationFileVersion": 2,
  "exposeDockerAPIOnTCP2375": {
    "locked": true,
    "value": false
  },
  "proxy": {
    "locked": true,
    "mode": "system",
    "http": "",
    "https": "",
    "exclude": [],
    "windowsDockerdPort": 65000,
    "enableKerberosNtlm": false,
    "pac": "",
    "embeddedPac": ""
  },
  "containersProxy": {
    "locked": true,
    "mode": "manual",
    "http": "",
    "https": "",
    "exclude": [],
    "pac": "",
    "embeddedPac": "",
    "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
  },
  "enableInference": {
    "locked": false,
    "value": true
  },
  "enableInferenceTCP": {
    "locked": false,
    "value": true
  },
  "enableInferenceTCPPort": {
    "locked": true,
    "value": 12434
  },
  "enableInferenceCORS": {
    "locked": true,
    "value": ""
  },
  "enableInferenceGPUVariant": {
    "locked": true,
    "value": true
  },
  "portBindingBehavior": {
    "locked": true,
    "value": "default-port-binding"
  }
}

Paso tres: Aplicar los ajustes

Los ajustes surten efecto después de reiniciar Docker Desktop y cuando el usuario inicia sesión.

Para nuevas instalaciones:

1. Abre Docker Desktop.
2. Inicia sesión con tu cuenta de Docker.

Para instalaciones existentes:

1. Cierra Docker Desktop por completo.
2. Vuelve a iniciar Docker Desktop.

Important

Debes cerrar completamente y volver a abrir Docker Desktop. Reiniciar desde el menú no es suficiente.

Configuraciones de admin-settings.json

Las siguientes tablas describen todos los ajustes disponibles en el archivo admin-settings.json.

Note

Algunos ajustes son específicos de la plataforma o requieren versiones mínimas de Docker Desktop. Revisa la columna Versión para conocer los requisitos.

Ajustes generales

Extensiones

Compartición de archivos y emulación

Docker Scout

Ajustes del Proxy

Proxy de contenedores

Ajustes de la VM Linux

Contenedores de Windows

Note

Este ajuste no está disponible para configurarse a través de la Consola de administración de Docker.

Ajustes de Kubernetes

Note

Al usar imagesRepository con el Aislamiento de Contenedores Mejorado (ECI), añade estas imágenes a la lista de imágenes de montaje de socket de Docker de ECI:

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

Estos contenedores montan el socket de Docker, por lo que debes añadirlos a la lista de imágenes de ECI. De lo contrario, ECI bloqueará el montaje y Kubernetes no se iniciará.

Ajustes de red

Para obtener más información, consulta Redes.

Ajustes de IA

Características Beta

Important

Para las versiones de Docker Desktop 4.41 y anteriores, algunos de estos ajustes se encontraban bajo la pestaña Experimental features (Características experimentales) en la página Features in development (Características en desarrollo).

Aislamiento de Contenedores Mejorado