Docker

Last published : Oct 24, 2026
Para instalar el servicio App Layering, se implementa el dispositivo en una máquina virtual en su hipervisor.
Related information
Instalar el dispositivo

Cómo instalar WSL y Docker

Estas instrucciones se aplican a todos los tipos de imágenes de App Layering, pero están destinadas principalmente para su uso con implementaciones completas de UserLayer de escritorios VDI no persistentes. Consulte la guía relacionada en Pasos de instalación manual para versiones anteriores de WSL. Para App Layering, estas instrucciones proporcionarán WSL y Docker como base para los usuarios de dominio en un grupo de máquinas virtuales VDI implementado.
Los usuarios de dominio que intenten usar WSL y/o Docker deben ser miembros del grupo de administradores de dominio. Usar una cuenta de administrador separada en nombre de un usuario de dominio durante la parte de usuario de estos pasos no funcionará.
Existen otros requisitos previos que no se cubren a continuación, como asegurarse de que las máquinas virtuales tengan la virtualización anidada habilitada (si planea usar WSL2), y tener una GPO de equipo presente para crear y rellenar un grupo 'docker-users' del que los usuarios deben ser miembros. Las versiones de Windows 10/11 deben estar actualizadas con la versión de WSL/Docker que se esté utilizando.

Guía paso a paso - Docker / WSLv2 (Win 10 o 11)

  1. En una nueva capa de aplicación (preferido), o revisión de capa de SO, como administrador:
    a) dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
    b) dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
    c. Deshabilitar las actualizaciones automáticas de WSL
    i.  reg add hklm\software\Microsoft\Windows\CurrentVersion\Lxss /t REG_DWORD /v AutoUpdate /d 0 /f
    d. Reinicie para instalar las características y luego inicie sesión de nuevo
    e. Descargue e instale la última versión estable de WSL desde Microsoft/WSL
    i.  Move the download to a place where users can access it later (do this BEFORE installing it)

    ii.  Install of WSL must be done from the same folder location that users will be using

        1.  Do not use the wsl --install command

        2.  Sample install command: 'msiexec -i wsl.2.3.26.0.x64.msi /L*V wsl-install.log'

        3.  Suggestion: create a "UserInstall.cmd" script containing a similar msiexec command to be used in step 2.a

    iii.  If an older WSL installation is present it should be uninstalled first (using 'msiexec /x' to fully remove it)

    iv.  It is not recommended to install a specific distro into the app layer. Users can choose a distro later if they wish to.

    v.  Do not remove the WSL .msi installer from this folder. Users will need to apply this exact .msi during their setup later.
    f. Use 'wsl --version' para verificar que WSL funciona
    g. (Opcional) añada un .wslconfig al perfil de usuario predeterminado
    i.  Existing users would need to copy this to their own profile

    ii.  The default network operation for wsl2 should be established in a file named .wslconfig and placed in \Users\Default.

        1.  .wslconfig contains two lines: '[wsl2]' and 'networkingMode=mirrored' (without quotes, case as shown)

        2.  Only new users-layer users will automatically have this file copied to their profile area

        3.  Place a copy of the .wslconfig file in the WSL installer location for existing users to copy
    h. Descargar e instalar Docker
    i.  See [Install Docker Desktop on Windows](https://docs.docker.com/desktop/install/windows-install/)

    ii.  Docker will log out

    iii.  Log back in (Docker will start itself, but this can be ignored now)

    iv.  'Accept' terms and Close the Docker Desktop sign-in window

    v.  In the latest releases of Docker, an error popup may appear at this time (see exact text of this popup in Info section below). Docker now seems to demand the presence of an installed distro. This popup can be dismissed and ignored, and Docker will exit due to this. That too can be ignored at this point in the installation steps.
    i. Finalizar la capa (para la capa de aplicación, debe incluirse en la imagen; no se entrega elásticamente)
  2. Para cada usuario que inicie sesión:
    a. Localizar y ejecutar el instalador de WSL (guardado del paso 1.e.i)
    i.  This will be a fast and minimal install that only sets up reparse-points for the user

    ii.  This is a one-time install for each user, but can be used again if wsl problems arise

    iii.  Do not copy the wsl .msi to an alternate location before installing it (e.g., 'cd \WSL' and repeat the original/similar msiexec command)
    b. Instalar una distribución privada usando powershell: (ejemplo usando la distribución ubuntu-1604)
    i.  Invoke-WebRequest -Uri [https://aka.ms/wsl-ubuntu-1604](https://aka.ms/wsl-ubuntu-1604) -OutFile ~/Ubuntu.zip -UseBasicParsing

    ii.  mkdir ~/distros

    iii.  Expand-Archive ~/Ubuntu.zip ~/distros/Ubuntu

    iv.  Run the installer as admin ~/distros/Ubuntu/ubuntu*.exe (exact name is version specific)

    v.  Provide a username and password you will use to log into wsl, and complete the install

    vi.  When this completes, update the distro in the distro-specific fashion ( sudo apt-get update; sudo apt-get upgrade )

    vii.  (Optional) create a desktop shortcut to the installed distro's main application

    viii.  Leave your distro window running for the remaining steps
    c. Iniciar Docker Desktop desde el menú de inicio
    i.  Allow Docker to initialize and start the docker engine

    ii.  Important: Docker needs to be made aware of your distro

        1.  In Docker, go to 'Setting->Resources→WSL Integration'

            a.  Enable the 'additional distro' that matches yours

            b.  Disable the 'default WSL distro' selection

    iii.  Also, you can control Docker auto-startup in 'Settings→General'

    iv.  Remember that your distro/WSL session needs to be started before the Docker engine can start successfully

Actualización

Cada vez que se implemente una versión actualizada de WSL/Docker App Layering, cada usuario afectado necesitará una operación de reparación utilizando la capa anterior de WSL/Docker.