Installare Docker Engine da binari (contenitori Windows)

Introdotto nella versione 11.3, ArcGIS Notebook Server con contenitori Windows supporta l'installazione di Docker Engine da binari.

Requisiti

L'installazione di Docker Engine da binari ha i requisiti seguenti:

Sistema operativo	Edizione Docker	Tipologia immagine (container) runtime del notebook	Ulteriori requisiti
Windows Server 2022 Standard and Datacenter	Docker Engine - versione Community 25.0.0 o versioni successive	Windows	Facoltativamente, è possibile installare Hyper-V. Nota: Sussistono limitazioni al numero massimo di contenitori su cui si può eseguire isolamento Hyper-V su Windows Server 2022 Standard. Per ulteriori informazioni, vedere Domande frequenti su Windows.

Installare Docker Engine da binari

Completare le operazioni seguenti per installare Docker Engine da binari:

1. Disinstallare qualsiasi versione precedente di Docker sul proprio computer.
2. Disabilitare la feature Contenitori sul server locale, se è abilitata.

   Per ulteriori informazioni, consultare la documentazione Microsoft.

3. Abilitare la feature Windows Contenitori eseguendo il seguente comando in Windows PowerShell con privilegi amministrativi:

   Add-WindowsFeature Containers

4. Seguire i prompt per riavviare il computer.
5. Verificare l'installazione della feature Contenitori eseguendo il comando seguente:

   Get-WindowsFeature Containers

6. Seguire le istruzioni riportate nella sezione Installare il server e i binari client su Windows nella documentazione Docker.

   Nota:

   Docker Engine dai binari non si aggiorna automaticamente. È necessario aggiornare manualmente alle versioni più recenti di Docker. Vedere Installa Docker Engine dalla documentazione sui binari per maggiori informazioni sulle limitazioni dell'uso diDocker dai binari in un ambiente di produzione. Sebbene questa pagina raccomandi di utilizzare Docker Desktop, ArcGIS Notebook Server con contenitori Windows non supporta Docker Desktop su Windows come motore del contenitore.

7. Aggiungere il percorso di directory del docker, ad esempio C:\Program Files\docker, alle variabili d'ambiente.
8. Verificare l'installazione e lo stato di esecuzione del daemon Docker eseguendo il comando seguente:

   docker version

Configurare Docker Engine

Completare la procedura seguente per configurare 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.