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 in due edizioni. Docker Desktop e Mirantis Container Runtime (precedentemente Docker Engine-Enterprise).
| 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.4.4 o successiva | Linux | Hyper-V obbligatorio |
Windows Server 2022 Standard e Datacenter | Mirantis Container Runtime versione 20.10 o successiva | Windows pubblicazione beta | Hyper-V è facoltativo. Sussistono limitazioni al numero massimo di contenitori su cui si può eseguire isolamento Hyper-V su Windows Server 2022 Standard. Consultare la sezione Windows FAQ per ulteriori informazioni. |
Con la versione ArcGIS Notebook Server 11.0, Docker Desktop è l'edizione appropriata da utilizzare con Windows. Il software permette all'utente di eseguire ArcGIS Notebook Server.
Nota:
Al momento della pubblicazione di ArcGIS Notebook Server 11.0, ArcGIS Notebook Server supporta Mirantis Container Runtime per Windows Server come pubblicazione beta. Per questa pubblicazione, si raccomanda di utilizzare ArcGIS Notebook Server con Mirantis Container Runtime a solo scopo di test.
Per ulteriori informazioni sull'utilizzo di Mirantis Container Runtime con ArcGIS Notebook Server nella versione 11.0, consultare Docker e ArcGIS Notebook Server.
Nota:
Docker e Mirantis Container Runtime sono componenti software di terze parti e il presente argomento potrebbe non fornire la procedura di installazione completa. Consultare i siti Docker e Mirantis Container Runtime per ulteriori informazioni circa i processi di installazione.
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, 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 richiede Docker Desktop per Windows (versione 4.4.4 o successiva).
- 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).
- Aprire la finestra prompt dei comandi ed eseguire i seguenti comandi:
docker version docker run hello-world
Configura impostazioni Docker
Dopo cheDocker è stato installato sul computer, modificare le impostazioni descritte di seguito.
Modificare 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.
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.
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 pulsante destro sul pulsante Docker nella barra delle applicazioni Windows e cliccare 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.
Installare Mirantis Container Runtime su Windows
Attenzione:
Mirantis Container Runtime su Windows è supportato come pubblicazione beta per ArcGIS Notebook Server su Windows Server 2022. Mentre sono in beta, queste feature potrebbero presentare problemi noti di prestazioni o qualità e non verranno supportate dal Supporto Tecnico di Esri. Non attivare Hyper-V, in quanto non è richiesto per l'installazione di Mirantis Container Runtime su Windows Server 2022. Non attivare la funzione Contenitori sul server locale prima dell'installazione di Mirantis Container Runtime.- Disinstallare qualsiasi versione precedente di Docker sul proprio computer.
- Attenersi alla procedura descritta nella documentazione Installare MCR su Windows Server fornita da Mirantis.
- Verificare che Mirantis Container Runtime sia propriamente installato e sia stato avviato, eseguendo il seguente comando:
docker run hello-world:nanoserver - Una volta completato, attenersi alla procedura di seguito per configurare Mirantis Container Runtime.
Configurare Mirantis Container Runtime
Attenersi alla procedura di seguito per configurare Mirantis Container Runtime sul proprio computer.
- Abilitare la porta 2375 per essere in grado di utilizzare l' Docker API remoto.
Questa porta verrà utilizzata solo internamente daArcGIS Notebook Server e dovrebbe essere protetta dall'utilizzo esterno.
Aprire un prompt di comando come amministratore ed eseguire il seguente comando:
sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://0.0.0.0:2375 -H npipe://" - Aprire una finestra di PowerShell come amministratore ed eseguire il seguente comando:
Restart-Service docker
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.