Preguntas frecuentes sobre el despliegue empresarial

MSI

Preguntas comunes sobre la instalación de Docker Desktop utilizando el instalador MSI.

¿Qué sucede con los datos del usuario si tiene una instalación anterior de Docker Desktop (es decir, .exe)?

Los usuarios deben desinstalar las instalaciones antiguas .exe antes de utilizar la nueva versión MSI. El instalador .exe incluye una bandera -keep-data que elimina Docker Desktop mientras conserva los recursos subyacentes, como las VM de los contenedores:

# Para instalaciones para todos los usuarios
& 'C:\Program Files\Docker\Docker\Docker Desktop Installer.exe' uninstall -keep-data

# Para instalaciones por usuario
& '%LOCALAPPDATA%\Programs\DockerDesktop\Docker Desktop Installer.exe' uninstall -keep-data

¿Qué sucede si la máquina del usuario tiene una instalación anterior de .exe?

El instalador MSI detecta las instalaciones anteriores .exe y bloquea la instalación hasta que se desinstale la versión anterior. Le solicita al usuario que desinstale su versión actual/antigua primero, antes de volver a intentar la instalación de la versión MSI.

Mi instalación falló, ¿cómo sé qué sucedió?

Las instalaciones MSI pueden fallar de forma silenciosa, ofreciendo pocos datos de diagnóstico.

Para depurar una instalación que ha fallado, ejecuta la instalación nuevamente habilitando el registro detallado (verbose):

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log"

Una vez que la instalación haya fallado, abre el archivo de registro y busca las ocurrencias de value 3. Este es el código de salida que muestra Windows Installer cuando falla. Inmediatamente arriba de esa línea, encontrarás la razón del fallo.

¿Por qué el instalador solicita reiniciar al final de cada instalación limpia?

El instalador solicita un reinicio porque asume que se han realizado cambios en el sistema que requieren un reinicio para finalizar su configuración.

Por ejemplo, si seleccionas el motor WSL, el instalador agrega las características de Windows requeridas. Una vez instaladas estas características, el sistema se reinicia para completar las configuraciones y que el motor WSL esté operativo.

Puedes evitar los reinicios utilizando la opción /norestart al iniciar el instalador desde la línea de comandos:

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /norestart

¿Por qué no se llena el grupo docker-users cuando se instala el MSI con Intune u otra solución de MDM?

Es común que las soluciones de MDM instalen aplicaciones en el contexto de la cuenta del sistema. Esto significa que el grupo docker-users no se llena con la cuenta del usuario, ya que la cuenta del sistema no tiene acceso al contexto del usuario.

Como ejemplo, puedes reproducir esto ejecutando el instalador con psexec en un símbolo del sistema con privilegios elevados:

psexec -i -s msiexec /i "DockerDesktop.msi"

La instalación debería completarse correctamente, pero el grupo docker-users no se llenará.

Como solución alternativa, puedes crear un script que se ejecute en el contexto de la cuenta de usuario.

El script se encargará de crear el grupo docker-users y agregar al usuario correcto a él.

Aquí tienes un script de ejemplo que crea el grupo docker-users y agrega al usuario actual a él (los requisitos pueden variar según el entorno):

$Group = "docker-users"
$CurrentUser = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name

# Crear el grupo
New-LocalGroup -Name $Group

# Agregar el usuario al grupo
Add-LocalGroupMember -Group $Group -Member $CurrentUser

Note

Después de agregar a un nuevo usuario al grupo docker-users, el usuario debe cerrar sesión y volver a iniciarla para que los cambios surtan efecto.

MDM

Preguntas comunes sobre el despliegue de Docker Desktop mediante herramientas de gestión de dispositivos móviles (MDM) como Jamf, Intune o Workspace ONE.

¿Por qué mi herramienta de MDM no aplica todas las configuraciones de Docker Desktop a la vez?

Algunas herramientas de MDM, como Workspace ONE, pueden no admitir la aplicación de múltiples configuraciones en un solo archivo XML. En estos casos, es posible que debas desplegar cada configuración en un archivo XML independiente.

Consulta la documentación de tu proveedor de MDM para conocer los requisitos o limitaciones específicos del despliegue.