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. Nota: 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.

   Nota:

   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. Se l'account utilizzato per installare ArcGIS Notebook Server non fa parte del gruppo degli amministratori, eseguire la seguente procedura:
   1. Dal menu Start del computer Windows, aprire l'applicazione Gestione del computer.
   2. Nella barra laterale sinistra, espandere la voce Utenti e gruppi locali e aprire la cartella Gruppi.
   3. Scegliere il gruppo Utenti Docker dall'elenco dei gruppi e fare doppio clic su di esso.

      Se un gruppo docker-users non esiste già, crearne uno.

   4. Fare clic sul pulsante Aggiungi, localizzare l'account utilizzato per installare ArcGIS Notebook Server e selezionarlo. Fare clic su OK per confermare.
   5. Fare clic su OK per chiudere la finestra di dialogo del gruppo.
   6. Creare un file di configurazione in C:\ProgramData\docker\config\daemon.json per impostare un gruppo di sicurezza per Docker.
   7. Modificare C:\ProgramData\docker\config\daemon.json per aggiungere il gruppo docker-users.

        
      {
        "group" : "docker-users"
      }

2. Abilitare la porta 2375 per abilitare l'utilizzo dell'API remoto Docker. Questa porta verrà utilizzata solo internamente daArcGIS Notebook Server e dovrebbe essere protetta dall'utilizzo esterno. Per abilitare la porta, aprire un prompt dei comandi come amministratore ed eseguire il seguente comando:
   sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://localhost:2375 -H npipe://"

3. Riavviare Docker con il seguente comando:

   net stop docker
   net start docker

4. Una volta installato il componente Docker, riavviare il computer.

   Nota:

   Ogni volta che il componente Docker viene installato o aggiornato è necessario riavviare il computer.

Modificare la posizione di installazione immagine Docker

Per modificare la posizione di installazione immagine Docker predefinita, eseguire la seguente procedura:

1. Modificare il file in C:\ProgramData\docker\config\daemon.json.
2. Impostare data-root sulla posizione scelta nel computer locale.

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

3. Riavviare Docker.