La seguente procedura descrive come scaricare, installare e configurare il software di allocazione contenitoreDocker richiesto da ArcGIS Notebook Server. Vedere Docker e ArcGIS Notebook Server per un'introduzione a Docker e come è usato in ArcGIS Notebook Server.
Edizioni Docker
Docker è disponibile come Docker Desktop.
| Sistema operativo | Edizione Docker | Tipologia immagine (container) runtime del notebook | Ulteriori requisiti |
|---|---|---|---|
Windows Server 2019 Standard e Datacenter Windows Server 2022 Standard e Datacenter | Docker Desktop su Windows versione 4.24.2 | Linux | Hyper-V obbligatorio |
Nota:
Docker è un componente software di terzi e questo argomento potrebbe non fornire il processo completo per installarlo. Per ulteriori informazioni sul processo di installazione, consulta il sito Docker.
Installare Docker Desktop
Completare le operazioni seguenti per installare Docker Desktop:
- Verificare che Hyper-V sia installato sul computer Windows cercando l'applicazione Hyper-V Manager. Se non è installato, installarlo prima di procedere. Consultare la seguente documentazione di Microsoft per la procedura:
- Se il sistema operativo è Windows Server 2022 o Windows Server 2019, consulta Installare il ruolo Hyper-V in Windows Server.
- Se il sistema operativo è Windows 10, consulta Installare Hyper-V su Windows 10.
ArcGIS Notebook Server richiede Docker Desktop per Windows (versione 4.24.2).
- In un browser, accedi alla pagina per il download di Docker Desktop (Windows) nello store Hub di Docker.
- Accedere all'account HubDocker esistente, o registrare un nuovo account.
- Scaricare il softwareDocker Desktop.
- Fare doppio clic su Docker per Windows Installer per eseguire l'installazione.
- Sulla finestra di dialogo Configurazione dell'installer, togliere la spunta a Utilizzare WSL2 invece di Hyper-V.
- Al termine, chiudere il programma di installazione.
- Fare clic sul pulsante Docker Desktop nel menu Avvia per avviare Docker.
- Verificare che Docker abbia iniziato a usare uno dei metodi seguenti:
- Selezionare lo stato dell'icona Docker nella barra delle applicazioni Windows (tipicamente situata nell'angolo in basso a destra dello schermo).
- Apri la finestra prompt dei comandi e utilizza i seguenti comandi:
docker version docker run hello-world
Configura impostazioni Docker
Dopo cheDocker è stato installato sul computer, modificare le impostazioni descritte di seguito.
Configurare le impostazioni generali
Si utilizzerà l'API remota di Docker, che richiede l'uso della porta 2375. Questa porta verrà utilizzata solo internamente daArcGIS Notebook Server e dovrebbe essere protetta dall'utilizzo esterno.
- Fare clic con il pulsante destro sul pulsante Docker nella barra delle applicazioni Windows e cliccare Impostazioni.
- Nella pagina Generale, selezionare Esponi daemon su tcp://localhost:2375 senza TLS.
È possibile ricevere un messaggio di avviso. Verificare che l'amministratore di sistema sia a conoscenza del fatto che tale porta è utilizzata internamente, e che non dovrebbe esserne permesso l'accesso dall'esterno.
- Togliere la spunta a Utilizzare il motore basato su WSL2 se l'opzione è spuntata.
Modificare la posizione di installazione dell'immagine Docker
Per modificare la posizione di installazione dell'immagine Docker predefinita, eseguire la seguente procedura:
- Aprire le impostazioni di Docker Desktop.
- Fare clic su Risorse > Avanzate.
- Impostare il Disk image location al percorso della directory locale scelto nel proprio computer.
Configurazione della condivisione file
Il container Docker deve avere accesso al drive locale che sarà configurato come la directory del workspace o una directory di dati personalizzati per il server notebook. Eseguire i passaggi in basso durante l'installazione iniziale e ripeterli ogni qualvolta le credenziali dell'account Run As cambiano o se lo stesso account Run As cambia. Se si crea un account durante l'installazione di ArcGIS Notebook Server, si verrà rinviati a queste procedure.
- Fare clic con il pulsante destro sul pulsante Docker nella barra delle applicazioni Windows e cliccare Impostazioni.
- Dal menu impostazioni, cliccare Risorse > Condivisione di file.
- Aggiungere il percorso drive o directory che sarà usato per il workspace ArcGIS Notebook Server o la directory di dati personalizzati.
Nota:
Se al momento non esiste una directory del workspace o una directory di dati personalizzati — ad esempio C:\arcgisnotebookserver — crea un sito ArcGIS Notebook Server o registra una directory di dati prima di eseguire questo passaggio.
Nota:
Docker per Windows supporta solo le directory su Windows che sono state condivise con i container Linux.
Configurare risorse avanzate
È possibile usare il pannello delle impostazioni Desktop Docker per limitare le risorse disponibili su ArcGIS Notebook Server e i contenitori in esecuzione nel sito server.
- Fare clic con il pulsante destro sul pulsante Docker nella barra delle applicazioni Windows e cliccare Impostazioni. Dal menu impostazioni, cliccare Risorse > Avanzate.
- Modifica le seguenti impostazioni:
- CPU: il numero di core della CPU disponibili per i contenitori sul computer. Per impostazione predefinita, questo è impostato su due core. È possibile aggiornare questo valore a seconda delle risorse disponibili sulla macchina e dei limiti di CPU impostati per i runtime del notebook.
- Memoria: la quantità di memoria disponibile per i contenitori sul computer. Per impostazione predefinita questo è impostato su 2 GB. Aumentare questo a un minimo di 6 GB. È possibile volerlo aumentare, a seconda delle risorse disponibili sulla macchina e dei limiti di memoria impostati per i runtime del notebook.
- Swap: la quantità di spazio su disco che i contenitori possono utilizzare per la memoria se viene raggiunto il limite impostato.
- Dimensione immagine disco: la dimensione dell'immagine di disco. Esaminare e aggiornare questo valore se necessario se si installano immagini di contenitori Docker per i risultati Notebooks all'esterno e all'interno di un errore di spazio su disco.
- Posizione immagine su disco: la directory dove i container e le immagini sono archiviate.
Nota:
Rivedere questo passo ogni volta che si fanno aggiornamenti alla CPU o alle risorse di memoria configurate per i runtime del notebook. - Una volta impostati i limiti desiderati per le risorse, fare clic su Applica.
Una volta installato il componente Docker, riavviare il computer. È necessario riavviare il computer ogni volta che si installa o si aggiorna il componente Docker.
Ora è possibile installare ArcGIS Notebook Server sul computer.