Install Docker Engine from binaries (Windows containers)

Introduced at 11.3, ArcGIS Notebook Server with Windows containers supports installing Docker Engine from binaries.

Requirements

Installing Docker Engine from binaries has the following requirements:

Operating system	Docker edition	Notebook runtime (Container) image type	Additional requirements
Windows Server 2022 Standard and Datacenter	Docker Engine - Community version 25.0.0 or later	Windows	Optionally, you can install Hyper-V. Notatka: There are limitations to the maximum number of containers that can run with Hyper-V isolation on Windows Server 2022 Standard. See the Windows FAQ for more information.

Install Docker Engine from binaries

Complete the following steps to install Docker Engine from binaries:

1. Uninstall any previous version of Docker on your machine.
2. Disable the Containers feature on your local server if it is enabled.

   See the Microsoft documentation for more information.

3. Enable the Windows Containers feature by running the following command in Windows PowerShell with administrative privileges:

   Add-WindowsFeature Containers

4. Follow the prompts to restart your machine.
5. Verify the installation of the Containers feature by running the following command:

   Get-WindowsFeature Containers

6. Follow the instructions in the Install server and client binaries on Windows section in the Docker documentation.

   Notatka:

   Docker Engine from binaries does not update automatically. You must manually update to newer versions of Docker. See the Install Docker Engine from binaries documentation for more information on the limitations of using Docker from binaries in a production environment. Although this page recommends using Docker Desktop, ArcGIS Notebook Server with Windows Containers does not support Docker Desktop on Windows as a container engine.

7. Add the docker directory path, for example, C:\Program Files\docker, to the environment path variables.
8. Verify your installation and Docker daemon running status by running the following command:

   docker version

Configure Docker Engine

Complete the following steps to configure Docker Engine:

1. Jeśli konto używane do zainstalowania serwera ArcGIS Notebook Server nie należy do grupy administratorów, wykonaj następujące czynności:
   1. Z menu Start na komputerze z systemem Windows otwórz aplikację Zarządzanie komputerem.
   2. Na pasku bocznym po lewej stronie rozwiń element Użytkownicy i grupy lokalne, a następnie otwórz folder Grupy.
   3. Wybierz grupę docker-users z listy grup i kliknij ją dwukrotnie.

      Jeśli grupa docker-users jeszcze nie istnieje, utwórz ją.

   4. Kliknij przycisk Dodaj, znajdź konto używane do zainstalowania serwera ArcGIS Notebook Server i je wybierz. Kliknij przycisk OK, aby potwierdzić.
   5. Kliknij przycisk OK, aby zamknąć okno dialogowe grup.
   6. Utwórz plik konfiguracyjny w katalogu C:\ProgramData\docker\config\daemon.json, aby skonfigurować grupę zabezpieczeń dla platformy Docker.
   7. Wykonaj edycję pliku C:\ProgramData\docker\config\daemon.json, aby dodać grupę docker-users.

        
      {
        "group" : "docker-users"
      }

2. Włącz port 2375, aby umożliwić korzystanie ze zdalnego interfejsu API Docker. Ten port będzie używany wewnętrznie przez aplikację ArcGIS Notebook Server i należy go chronić przed użyciem z zewnątrz. Aby włączyć port, otwórz wiersz poleceń jako administrator i wykonaj następujące polecenie:
   sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://localhost:2375 -H npipe://"

3. Uruchom ponownie środowisko Docker za pomocą następującej komendy:

   net stop docker
   net start docker

4. Po zainstalowaniu komponentu Docker uruchom ponownie komputer.

   Notatka:

   Po każdej instalacji lub aktualizacji komponentu Docker należy ponownie uruchomić komputer.

Zmiana domyślnej lokalizacji instalacji obrazu Docker

Aby zmienić domyślną lokalizację instalacji obrazu Docker, wykonaj poniższe czynności:

1. Edytuj plik w C:\ProgramData\docker\config\daemon.json.
2. Skonfiguruj ustawienie data-root na wybraną lokalizację na komputerze lokalnym.

    {
   "data-root": "d:\\docker"
   }

3. Uruchom ponownie serwer Docker