Skip To Content

Installa il motore dei contenitori per ArcGIS Notebook Server (contenitori Linux)

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 operativoEdizione DockerTipologia immagine (container) runtime del notebookUlteriori 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:

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

    ArcGIS Notebook Server richiede Docker Desktop per Windows (versione 4.24.2).

  2. In un browser, accedi alla pagina per il download di Docker Desktop (Windows) nello store Hub di Docker.
  3. Accedere all'account HubDocker esistente, o registrare un nuovo account.
  4. Scaricare il softwareDocker Desktop.
  5. Fare doppio clic su Docker per Windows Installer per eseguire l'installazione.
  6. Sulla finestra di dialogo Configurazione dell'installer, togliere la spunta a Utilizzare WSL2 invece di Hyper-V.
  7. Al termine, chiudere il programma di installazione.
  8. Fare clic sul pulsante Docker Desktop nel menu Avvia per avviare Docker.
  9. 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
      Il primo comando fornisce la versione diDocker sul computer; il secondo verifica cheDocker possa accedere ed eseguire le immagini del contenitore.

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.

  1. Fare clic con il pulsante destro sul pulsante Docker nella barra delle applicazioni Windows e cliccare Impostazioni.
  2. 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.

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

  1. Aprire le impostazioni di Docker Desktop.
  2. Fare clic su Risorse > Avanzate.
  3. 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.

  1. Fare clic con il pulsante destro sul pulsante Docker nella barra delle applicazioni Windows e cliccare Impostazioni.
  2. Dal menu impostazioni, cliccare Risorse > Condivisione di file.
  3. 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:\arcgisnotebookservercrea 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.

  1. Fare clic con il pulsante destro sul pulsante Docker nella barra delle applicazioni Windows e cliccare Impostazioni. Dal menu impostazioni, cliccare Risorse > Avanzate.
  2. 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.

  3. 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.