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.
Scaricare e installare Docker
L'edizione Docker necessaria per eseguire ArcGIS Notebook Server su Windows è Docker Desktop Community. È accessibile tramite l'applicazione Docker Desktop per Windows. Attenersi alla procedura per installareDocker sul computer.
- 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 2019, consultare Installare il ruolo Hyper-V su Windows Server.
- Se il sistema operativo è Windows 10, consultare Installare Hyper-V su Windows 10.
ArcGIS Notebook Server richiedeDocker Desktop perWindows (versione 2.4.0.0 o versione successiva).
- In un browser, accedere 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.
- Nella finestra di dialogo Configurazione del programma di installazione, non consentire a Docker di utilizzare i contenitori Windows in quanto ArcGIS Notebook Server richiede i contenitori Linux.
- 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).
- Aprire la finestra prompt dei comandi ed eseguire i seguenti comandi:
Il primo comando fornisce la versione diDocker sul computer; il secondo verifica cheDocker possa accedere ed eseguire le immagini del contenitore.docker version docker run hello-world
Configura impostazioni Docker
Dopo cheDocker è stato installato sul computer, modificare le impostazioni descritte di seguito.
Utilizzare la porta 2375
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 fare clic su 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.
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 questa procedura.
- Fare clic con il tasto destro sul pulsante Docker nella barra delle applicazioni Windows e fare clic su 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.
Limitare le 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 tasto destro sul pulsante Docker nella barra delle applicazioni Windows e fare clic su Impostazioni. Dal menu impostazioni, cliccare Risorse > Avanzate.
- Facoltativamente, modificare 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.