App-Layering

Docker

Um den App Layering-Dienst zu installieren, stellen Sie die Appliance auf einer virtuellen Maschine auf Ihrem Hypervisor bereit.

So installieren Sie WSL und Docker

Diese Anweisungen gelten für alle App Layering-Imagetypen, sind jedoch in erster Linie für die Verwendung mit vollständigen UserLayer-Bereitstellungen nicht persistenter VDI-Desktops vorgesehen. Weitere Informationen finden Sie unter Manuelle Installationsschritte für ältere Versionen von WSL. Für App Layering stellen diese Anweisungen WSL und Docker als Basis für Domänenbenutzer in einem bereitgestellten VDI-Pool von VMs bereit.

Domänenbenutzer, die versuchen, WSL und/oder Docker zu verwenden, müssen Mitglieder der Domänenadministratorgruppe sein. Die Verwendung eines separaten Administratorkontos im Namen eines Domänenbenutzers während des Benutzerteils dieser Schritte funktioniert nicht.

Es gibt noch weitere Voraussetzungen, die unten nicht behandelt werden. Dazu gehört beispielsweise, sicherzustellen, dass die verschachtelte Virtualisierung auf den virtuellen Maschinen aktiviert ist (wenn Sie WSL2 verwenden möchten) und dass ein Computer-GPO vorhanden ist, um eine Gruppe „Docker-Benutzer“ zu erstellen und aufzufüllen, deren Mitglieder die Benutzer sein müssen. Die Windows 10/11-Versionen sollten mit der verwendeten WSL/Docker-Version auf dem neuesten Stand sein.

Schritt-für-Schritt-Anleitung – Docker / WSLv2 (Win 10 oder 11)

  1. In einer neuen App-Ebene (bevorzugt) oder einer OS-Ebenenrevision als Administrator:

    A. dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

    B. dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

    C. Deaktivieren Sie automatische WSL-Updates

      i.    reg add hklm\software\Microsoft\Windows\CurrentVersion\Lxss /t REG_DWORD /v AutoUpdate /d 0 /f
    

    D. Starten Sie neu, um Funktionen zu installieren, und melden Sie sich dann erneut an

    e. Laden Sie die neueste stabile WSL-Version von Microsoft/WSLherunter und installieren Sie sie

      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. Verwenden Sie „wsl –version“, um zu überprüfen, ob WSL funktioniert

    G. (Optional) Fügen Sie dem Standardbenutzerprofil eine .wslconfig hinzu

      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. Herunterladen und Installieren von 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. ich.  Finalisieren Sie die Ebene (muss für die App-Ebene im Bild enthalten sein; wird nicht elastisch bereitgestellt)
    
  2. Für jeden sich anmeldenden Benutzer:

    A. Suchen und führen Sie das WSL-Installationsprogramm aus (gespeichert aus Schritt 1.ei).

      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. Installieren Sie eine private Distribution mit Powershell: (Beispiel mit der Distribution 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. Starten Sie Docker Desktop über das Startmenü

      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
    

Upgrade durchführen

Jedes Mal, wenn ein aktualisiertes WSL/Docker App Layering eingeführt wird, muss jeder betroffene Benutzer einen Reparaturvorgang mit der vorherigen WSL/Docker-Ebene durchführen.

Docker