Il software di allocazione dei contenitori di Docker viene utilizzato da ArcGIS Notebook Server.
Software Docker
ArcGIS Notebook Server utilizza Dockersoftware di allocazione dei contenitori per fornire sicurezza e isolare le risorse per gli autori dei notebook. I contenitori sono sistemi operativi virtualizzati, al contrario delle macchine virtuali: ogni contenitore su un computer include tutti i componenti del sistema operativo in un ambiente isolato. ArcGIS Notebook Server fornisce un contenitore separato per ogni utente del sito. Ogni utente possiede un contenitore per ogni runtime e gli utenti possono eseguire solo notebook nel proprio contenitore.
Docker è una componente software separata, di terza parte che deve essere installata su ogni computer ArcGIS Notebook Server prima di usare ArcGIS Notebook Server.
Immagini del contenitore di Docker
Quando si ricevono i download dei software e i file di autorizzazione da My Esri prima dell'installazione, si ricevono anche due immagini dei contenitori Docker specifiche per ArcGIS Notebooks. Queste immagini dei contenitori forniscono il runtime necessario — una raccolta specifica di moduli Python — per gli utenti dei notebook.
Esri fornisce due immagini dei contenitori Docker: Standard e Avanzata. Queste due immagini del contenitore includono strumenti di sistema e librerie, oltre a varie impostazioni per configurare il contenitore in modo appropriato. Includono inoltre il runtime del notebook: l'immagine del contenitore Standard include il runtime del notebook Standard, e l'immagine del contenitore Avanzata include il runtime Avanzato.
Il runtime Standard consente a ArcGIS Notebooks di utilizzare il codice di moduli di terzi e ArcGIS API for Python. Il runtime Avanzato contiene tutti i moduli dell'immagine Standard e comprende anche ArcPy e le relative librerie.
Se si dispone della licenza Avanzato, si dovrebbe scaricare e installare entrambe le immagini container da My Esri. I moduli Python contenuti nelle immagini Standard e Avanzata sono elencati in Visualizzare le librerie di Python disponibili.
Per creare notebook utilizzando il runtime Avanzato, agli utenti deve essere assegnato un ruolo nel portale che includa il privilegio Notebook avanzati. La prima volta che apriranno un notebook, verrà avviato un contenitore, con l'immagine del contenitore avanzata applicata su di esso.
Gli autori di notebook con il privilegio Notebook avanzati possono anche specificare un notebook per utilizzare il runtime Standard. Ciò permette loro di condividere i notebook che hanno creato con gli utenti che hanno accesso solo al runtime Standard. La prima volta che eseguiranno tale operazione, verrà lanciato un secondo contenitore, caricato con l'immagine del contenitore Standard.
Maggiori informazioni sui privilegi degli utenti di notebook
Per impostazione predefinita, a ogni contenitore viene assegnata una certa quantità di RAM e un certo numero di condivisioni del core della CPU. Questi limiti di risorse predefiniti sono determinati dal runtime eseguito dal contenitore come segue:
- Il runtime Standard assegna 1 core della CPU e 4 GB di RAM a ogni contenitore.
- Il runtime Avanzato assegna 2 core della CPU e 6 GB di RAM a ogni contenitore.
Come amministratore ArcGIS Notebook Server, è possibile controllare il numero di autori di notebook che lavorano nel proprio sito e il runtime utilizzato da ciascuno. In base a questi fattori potrebbe essere necessario o preferibile modificare i limiti di risorse impostati per ArcGIS Notebook Server.
Edizioni Docker
Per Windows gli utenti, Docker Desktop è l'edizione appropriata. Questo software consente di eseguire ArcGIS Notebook Server..
Accertarsi di installare Docker Desktop 4.4.4 o versioni successive su ogni macchina ArcGIS Notebook Server. Per ulteriori informazioni sull'installazione e la configurazione di Docker, consultare Installazione di Docker per ArcGIS Notebook Server.
Nota:
ArcGIS Notebook Server funzionerà solo con una delle edizioni di Docker installate su una macchina. Non è possibile mescolare le edizioni in un sito multimacchina.
Runtime dei notebook e immagini dei contenitori
Quando un contenitore viene avviato per la prima volta, è del tutto vuoto. Le librerie di sistema, gli strumenti e le configurazioni di cui il contenitore ha bisogno per funzionare sono forniti attraverso un file immagine del contenitore. L'immagine del contenitore viene applicata al contenitore come parte del processo di avvio.
Suggerimento:
Se è stato distribuito un software cloud, probabilmente si avrà familiarità con le immagini dei computer, che forniscono alle macchine virtuali vuote il codice, gli strumenti e le impostazioni necessarie per funzionare. Le immagini dei contenitori funzionano allo stesso modo per il sistema operativo virtuale vuoto del contenitore.
Esri fornisce due immagini dei contenitori per ArcGIS Notebook Server. In ogni immagine dei contenitori è incluso un runtime dei notebook, che rende disponibili le risorse Python in ArcGIS Notebooks. Ogni runtime crea pacchetti di un elenco di queste librerie e dipendenze, inclusa una versione specifica di ogni libreria di Python.
I due runtime di ArcGIS Notebook Server — Standard (che include ArcGIS API for Python e altri moduli di Python) e Avanzata (che include anche ArcPy) — sono disponibili nei notebook come parte dell'immagine del contenitore corrispondente.
Visualizzare le librerie disponibili in ogni runtime
A seconda della licenza, si riceverà l'immagine del contenitore Standard o entrambe le immagini del contenitore Standard e Advanced.
Su macchine Windows, i contenitori in un sito ArcGIS Notebook Server con contenitori Linux sono gestiti in un emulatore di Linux denominato MobyLinuxVM, contenuto nell'ambiente Hyper-V. Di conseguenza, il ruolo Hyper-V deve essere installato sulla macchina. Questo requisito è incluso nei requisiti di sistema di ArcGIS Notebook Server.
Quando viene avviato un contenitore, una delle due immagini del contenitore ricevuta da Esri viene applicata al contenitore. Il runtime e l'immagine applicata dipende dai privilegi dell'autore del notebook nel portale:
- Per gli autori che dispongono solo di privilegi del tipo Crea e modifica appunti, il contenitore verrà caricato con l'immagine del contenitore Standard. Tutti i notebook che aprono utilizzeranno il runtime Standard.
- Per gli autori che dispongono anche di privilegi del tipo Notebook avanzati, il contenitore verrà caricato con l'immagine del contenitore Avanzata. Il runtime predefinito per i notebook è il runtime Avanzato. Tuttavia, potranno specificare il runtime di un singolo notebook e utilizzare il runtime Standard o Avanzato nei loro notebook.
Maggiori informazioni sui privilegi degli utenti di notebook
Prerequisiti e vincoli per i sistemi Windows
Se si implementa ArcGIS Notebook Server su computer Windows, ci sono una serie di prerequisiti e vincoli da tenere in considerazione. Questi non si applicano quando si implementa ArcGIS Notebook Server su macchine Linux.
prerequisiti Docker Desktop
Di seguito sono riportati i requisiti necessari prima di utilizzare Docker Desktop:
- Si raccomanda di utilizzare computer Windows Server 2019 in un ambiente di produzione di ArcGIS Notebook Server. I computer Windows 10 sono supportati solo per gli ambienti di sviluppo.
- Se si distribuisce ArcGIS Notebook Server su Windows Server 2019, si può usare Docker Desktop (versione 4.4.4 o successiva). Occorre notare che la documentazione Docker della versione attuale non menziona Windows Server 2019 nei suoi requisiti di sistema.
- ArcGIS Notebook Server 10.8.x non supporta più Windows Server 2016.
- ArcGIS Notebook Server utilizza contenitori Linux nel suo componente Docker. Su macchine Windows, i contenitori in un sito ArcGIS Notebook Server sono gestiti in un emulatore di Linux denominato MobyLinuxVM, contenuto nell'ambiente Hyper-V.
- ArcGIS Notebook Server richiede il ruolo Hyper-V già installato in Windows Server e Windows 10.
- Determinati ambienti di virtualizzazione non consentono l'abilitazione e l'uso di Hyper-V in Windows. Di conseguenza, ArcGIS Notebook Server non può essere installato ed eseguito in tali ambienti.
- Il servizio Docker Desktop smetterà di funzionare quando l'utente esegue l'installazione Docker dal computer ArcGIS Notebook Server in cui Docker è installato. Il computer ArcGIS Notebook Server può essere bloccato, ma l'utente deve aver effettuato l'accesso a Docker per funzionare correttamente. Se l'utente non ha eseguito l'accesso, l'apertura dei notebook avrà esito negativo con il messaggio Impossibile caricare l'errore del notebook.
Nota:
Ci sono soluzioni alternative per eseguire Docker Desktop automaticamente al riavvio del computer ArcGIS Notebook Server, invece di avere l'accesso dell'utente.
- A partire dalla versione 10.7.1, ArcGIS Notebook Server supporta siti a più computer. Nei sistemi Windows, Docker non supporta il montaggio di unità condivise sui contenitori, quindi la directory del workspace deve rimanere locale su ciascun computer. Dal momento che gli utenti possono avviare contenitori e aprire appunti su ciascun computer in un sito a più computer, è necessario che il contenuto nella directory del workspace sia sincronizzato tra i vari computer. I passaggi per configurare un metodo di replica sono descritti in Configurazione della replica DFS per ArcGIS Notebook Server.