Moteurs de conteneurisation et ArcGIS Notebook Server
Le logiciel d’allocation de conteneurs Docker est utilisé par ArcGIS Notebook Server.
Logiciel Docker
ArcGIS Notebook Server utilise le logiciel d’allocation de conteneurs Docker pour garantir la sécurité et isoler les ressources destinées aux créateurs de notebooks. Les conteneurs sont des systèmes d’exploitation virtualisés, par opposition aux machines virtuelles. Chaque conteneur sur un ordinateur comporte tous les composants du système d’exploitation dans un environnement isolé. ArcGIS Notebook Server fournit un conteneur distinct pour chaque utilisateur du site. Chaque utilisateur possède un conteneur par exécution, et les utilisateurs ne peuvent exécuter que des notebooks dans leur propre conteneur.
Docker est un composant logiciel tiers distinct qui doit être installé sur chaque machine ArcGIS Notebook Server avant d’utiliser ArcGIS Notebook Server.
Images de conteneur Docker
Lorsque vous recevez les téléchargements logiciels et les fichiers d’autorisation de My Esri avant l’installation, vous recevez également deux images de conteneur Docker spécifiques à ArcGIS Notebooks. Ces images de conteneur fournissent le runtime nécessaire, une collection spécifique de modules Python, à l’intention des utilisateurs de notebook.
Esri fournit deux images de conteneur Docker : Standard et Advanced. Ces deux images de conteneur incluent des outils et des bibliothèques système, ainsi que différents paramètres permettant de configurer le conteneur de façon appropriée. Elles incluent également une exécution de notebook : l’image de conteneur Standard inclut l’exécution de notebook Standard et l’image de conteneur Advanced inclut l’exécution Advanced.
Le runtime Standard permet à ArcGIS Notebooks d’utiliser le code d’ArcGIS API for Python et de modules de tierce partie. L’exécution Advanced contient tous les modules de l’image Standard, ainsi que des bibliothèques ArcPy et associées.
Si vous disposez d’une licence Advanced, téléchargez et installez les deux images de conteneur depuis My Esri. Les modules Python inclus dans les images Standard et Advanced sont répertoriés dans la rubrique Afficher les bibliothèques Python disponibles.
Pour créer des notebooks à l’aide de l’exécution Advanced, un rôle doit être défini pour un utilisateur dans le portail qui inclut le privilège Advanced Notebooks (Notebooks Advanced). Lorsqu’un utilisateur ouvre un notebook pour la première fois, un conteneur auquel est appliqué l’image de conteneur Advanced est lancé.
Les créateurs de notebooks disposant du privilège Advanced Notebooks (Notebooks Advanced) peuvent également spécifier qu’un notebook utilise l’exécution Standard. Cela leur permet de partager les notebooks qu’ils ont créés avec des utilisateurs qui n’ont accès qu’à l’exécution Standard. La première fois qu’ils partagent des notebooks, un second conteneur, dans lequel l’image de conteneur Standard est chargé, se lance.
En savoir plus sur les privilèges des utilisateurs de notebook
Par défaut, un conteneur se voit allouer une certaine quantité de RAM et un certain nombre de partages de cœurs de processeur. Ces limites de ressources par défaut sont déterminées par le runtime exécuté par le conteneur, comme suit :
Le runtime standard alloue 1 cœur de processeur et 4 Go de RAM par conteneur.
Le runtime avancé alloue 2 cœurs de processeur et 6 Go de RAM par conteneur.
En tant qu’administrateur ArcGIS Notebook Server, surveillez le nombre de créateurs de notebook qui travaillent sur votre site et le runtime utilisé par chacun d’eux. En fonction de ces facteurs, vous aurez peut-être besoin de modifier les limites de ressources définies pour ArcGIS Notebook Server.
Éditions de Docker
Docker se décline en deux éditions. Docker et Mirantis Container Runtime (anciennement Docker Engine-Enterprise). Les deux éditions sont considérées comme complètes sur le plan des fonctionnalités.
Remarque :
Consultez la FAQ sur Docker pour plus d’informations sur la version et la tarification de Docker.
Veillez à installer Docker ou Mirantis Container Runtime sur chaque machine ArcGIS Notebook Server. Pour plus d’informations sur l’installation et la configuration de Docker, reportez-vous à la rubrique Installer Docker pour ArcGIS Notebook Server.
Remarque :
ArcGIS Notebook Server ne fonctionne qu’avec une seule des éditions de Docker installées sur une machine. Vous pouvez combiner les éditions sur des sites à plusieurs ordinateurs.
Runtimes de notebook et images de conteneur
À son premier lancement, un conteneur est généralement vide. Les bibliothèques du système, les outils et les configurations requises par le conteneur pour fonctionner sont fournis via un fichier d’image de conteneur. L’image de conteneur est appliquée au conteneur lors du lancement.
Conseil :
Si vous avez déployé des logiciels sur le cloud, vous connaissez sûrement les images de machine, qui fournissent aux machines virtuelles vides le code, les outils et les paramètres dont elles ont besoin pour fonctionner. Les images de conteneur fonctionnent de la même manière pour le système d’exploitation virtuel vide du conteneur.
Esri fournit deux images de conteneur pour ArcGIS Notebook Server. Dans chaque image de conteneur est inclus un runtime de notebook, qui met à disposition les ressources Python dans ArcGIS Notebooks. Chaque paquetage d’exécution comprend une liste de ces bibliothèques et dépendances, y compris une version spécifique de chaque bibliothèque Python.
Les deux runtimes ArcGIS Notebook Server, Standard (comprenant ArcGIS API for Python et d’autres modules Python) et Advanced (comprenant aussi ArcPy), sont disponibles dans les notebooks, dans l’image de conteneur correspondante.
Afficher les bibliothèques disponibles dans chaque runtime
En fonction de votre licence, vous recevez uniquement l’image de conteneur Standard ou les deux images de conteneur Standard et Advanced.

Lorsqu’un conteneur est lancé, une des deux images de conteneur envoyées par Esri s’applique au conteneur. Le runtime et l’image appliquée dépendent des privilèges du créateur du notebook dans le portail :
Le conteneur des créateurs qui disposent uniquement du privilège Create and Edit Notebooks (Créer et mettre à jour des notebooks) inclura l’image de conteneur standard. Tous les notebooks ouverts par ces auteurs utilisent le paquetage d’exécution Standard.
Le conteneur des auteurs qui disposent également du privilège Advanced Notebooks (Notebooks avancés) est chargé avec l’image de conteneur Advanced. Le paquetage d’exécution de leurs notebooks par défaut est Advanced. Toutefois, ils ont la possibilité de spécifier un runtime de notebook individuel et peuvent utiliser le runtime Standard ou Advanced dans leurs notebooks.
En savoir plus sur les privilèges des utilisateurs de notebook
ArcGIS Notebook Server est compatible avec les conteneurs Windows en utilisant Mirantis Container Runtime ou Docker Engine à partir de binaires comme options de moteur de conteneurisation sous Windows.
Moteurs de conteneurisation pour Windows
À l’instar d’autres déploiements ArcGIS Notebook Server, ArcGIS Notebook Server avec des conteneurs Windows est installé sur un système d’exploitation de serveur et est configuré et fédéré avec un portail ArcGIS Enterprise. En outre, il est possible de déployer une instance Web Adaptor devant le logiciel ArcGIS Notebook Server.
ArcGIS Notebook Server utilise des systèmes d’exploitation virtualisés, connus sous le nom de conteneurs, pour isoler les environnements des créateurs de notebook. Les conteneurs permettent ainsi à chaque auteur d’utiliser un sous-ensemble des ressources de serveur sans que leur travail ou l’utilisation des ressources interfère avec le travail d’autres personnes.
Ces conteneurs sont alloués et maintenus par un moteur de conteneurisation tiers, à savoir Mirantis Container Runtime ou Docker Engine à partir de binaires. Avant d’installer ArcGIS Notebook Server, vous devez installer un moteur de conteneurisation. Une fois ArcGIS Notebook Server installé, il doit être configuré pour fonctionner avec ce moteur de conteneurisation.
ArcGIS Notebook Server alloue un seul conteneur par runtime à chaque créateur de notebook du site, et seuls ces derniers peuvent travailler dans le conteneur. Les ressources de calcul qu’ils utilisent lors de l’exécution des notebooks n’affectent pas les conteneurs des autres auteurs.
Lorsqu’un membre du portail doté des privilèges correspondants ouvre son premier notebook, un conteneur est lancé sur le site ArcGIS Notebook Server. Cette session entre le notebook et le conteneur dure le temps du notebook.
ArcGIS Notebook Server peut joindre plusieurs machines à un même site. Toutes les machines d’une configuration comportant plusieurs machines doivent être configurées de manière identique et chaque machine peut exécuter ArcGIS Notebooks.
Runtimes de notebook et images de conteneur Windows
Une seule image de conteneur Windows est fournie pour ArcGIS Notebook Server. Cette image de conteneur inclut les runtimes de notebook Standard et Advanced, qui assurent la disponibilité des ressources Python dans ArcGIS Notebooks. Pour plus d’informations sur les bibliothèques disponibles dans chaque runtime, reportez-vous à la rubrique Bibliothèques Python disponibles.
Les deux runtimes ArcGIS Notebook Server, Standard et Advanced, sont disponibles dans les notebooks, dans l’image de conteneur. En fonction de la licence et des privilèges utilisateur dont vous disposez, vous pouvez utiliser soit le runtime Standard, soit les deux runtimes Standard et Advanced.
Les conteneurs Windows d’un site ArcGIS Notebook Server prennent en charge deux modes d’isolement de runtime : processus et Hyper-V. Pour plus d’informations sur ces modes, reportez-vous à la rubrique Modes d’isolement de la documentation Microsoft. Si vous configurez le site en vue de l’utilisation de l’isolement Hyper-V, le rôle Hyper-V doit être installé sur la machine. Consultez la documentation Microsoft pour obtenir plus d’informations sur l’installation d’Hyper-V pour Windows Server.
Remarque :
Certaines limitations affectent le nombre de conteneurs pouvant être exécutés pendant l’utilisation de conteneurs Windows avec Hyper-V. Pour plus d’informations, consultez la rubrique Questions fréquentes sur les conteneurs de la documentation Microsoft.


Lorsqu’un conteneur est lancé, l’image de conteneur Windows fournie par Esri est appliquée au conteneur. Le runtime dépend de la licence configurée pour ArcGIS Notebook Server et des privilèges du créateur du notebook.
Remarque :
Une limitation connue est susceptible d’entraîner une erreur WinError 1455 lors de l’importation de la bibliothèque torch ou des bibliothèques Python qui possèdent une dépendance torch. Reportez-vous à la rubrique Problèmes courants et solutions pour plus d’informations.
Conditions requises et contraintes pour les systèmes Windows
Si vous déployez ArcGIS Notebook Server sur des machines Windows avec des conteneurs Windows, différentes conditions requises et contraintes doivent être prises en compte.
Conditions requises pour Mirantis Container Runtime
Gardez les points suivants à l’esprit lorsque vous utilisez Mirantis Container Runtime :
Actuellement, Mirantis Container Runtime prend seulement en charge Windows Server 2022.
Lorsque ArcGIS Notebook Server et Mirantis Container Runtime sont déployés sur plusieurs machines, il n’est plus nécessaire de configurer la réplication (DFS) pour votre répertoire d’espace de travail. Le répertoire d’espace de travail peut être partagé sous forme de chemin monté sur un disque avec Mirantis Container Runtime.