Installer ArcGIS Notebook Server et des conteneurs Windows

À la version 11.0, ArcGIS Notebook Server avec les conteneurs Windows et Mirantis Container Runtime est disponible en tant que version bêta sur Windows.

Remarque :

Dans la version bêta, il se peut que ces fonctionnalités aient rencontré des problèmes de performances ou de qualité et elles ne seront pas prises en charge par le support technique d’Esri.

Conteneurs ArcGIS Notebook Server et 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. Il est de plus possible de déployer un adaptateur Web 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 auteurs 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 gérés par Mirantis Container Runtime, anciennement Docker Engine Enterprise, un composant logiciels tiers. Avant d’installer ArcGIS Notebook Server, vous devez installer Mirantis Container Runtime version 20.10 ou ultérieure. Une fois ArcGIS Notebook Server installé, il doit être configuré pour fonctionner avec Mirantis Container Runtime.

ArcGIS Notebook Server alloue un conteneur par exécution à chaque auteur 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 connecter plusieurs machines ensemble sur un 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 conteneurs Windows

Esri fournit une seule image de conteneur Windows 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 : traitement et Hyper-V. Pour plus d’informations sur ces modes, consultez la rubrique Modes d’isolement dans 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.

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 cette FAQ 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 de l’auteur du notebook.

Remarque :

Dans la version 11.0, 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.

Remarque :

fiona, rasterstats et rasterio ne sont pas installés dans les conteneurs Windows.

Configurer les logiciels prérequis

Avant d’installer ArcGIS Notebook Server, vous devez installer et configurer les logiciels prérequis suivants.

Configuration du système

Pour que vous puissiez installer ArcGIS Notebook Server avec des conteneurs Windows, les conditions suivantes doivent être remplies :

• Windows Server 2022 est le seul système d’exploitation pris en charge pour ArcGIS Notebook Server avec des conteneurs Windows.
• ArcGIS Notebook Server avec des conteneurs Windows requiert Mirantis Container Runtime version 20.10 ou ultérieure.
• Hyper-V est facultatif, selon le mode d’isolement des runtimes sélectionné pour le site ArcGIS Notebook Server.
• ArcGIS Notebook Server avec des conteneurs Windows requiert un minimum de 75 Go d’espace disque disponible.
• Vérifiez la configuration système requise de ArcGIS Notebook Server.

Activer Hyper-V (facultatif)

Hyper-V est requis uniquement si vous envisagez d’exécuter des conteneurs Windows en mode d’isolement Hyper-V.

Pour activer Hyper-V, reportez-vous à la rubrique Installer le rôle Hyper-V sur Windows Server dans la documentation Microsoft.

Installation de Mirantis Container Runtime

Pour installer Mirantis Container Runtime sur une machine, procédez comme indiqué ci-après.

1. Désinstallez les versions précédentes de Docker installées sur votre machine.
2. N’activez pas la fonctionnalité Containers (Conteneurs) sur le serveur local avant d’installer Mirantis Container Runtime. Si cette fonctionnalité est déjà activée, désactivez-la sur la machine serveur. Pour plus d’informations, reportez-vous à la rubrique Installer ou désinstaller des rôles, des services de rôle ou des fonctionnalités dans la documentation Microsoft.
3. Suivez la procédure décrite dans la rubrique Install Mirantis Container Runtime on Windows Server dans la documentation Mirantis.
4. Vérifiez que Mirantis Container Runtime est installé et qu’il a été démarré en exécutant la commande suivante :
   docker run hello-world:nanoserver

5. Ceci fait, procédez comme suit pour configurer Mirantis Container Runtime.

Configurer Mirantis Container Runtime

1. Activez le port 2375 pour activer l’utilisation de l’API distante Docker. Ce port sera uniquement utilisé en interne par ArcGIS Notebook Server et doit être protégé de tout usage externe. Pour activer le port, ouvrez une invite de commande en tant qu’administrateur et exécutez la commande suivante :
   sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://localhost:2375 -H npipe://"

2. Ouvrez une fenêtre PowerShell en tant qu’administrateur et exécutez la commande suivante :

   Restart-Service docker

3. Une fois le composant Docker installé, redémarrez votre machine.

   Remarque :

   À chaque fois que vous installez ou mettez à niveau le composant Docker, vous devez redémarrer la machine.

Installation de ArcGIS Notebook Server

Suivez la procédure décrite dans la rubrique d’aide Installer ArcGIS Notebook Server pour installer ArcGIS Notebook Server à l’aide de l’assistant d’installation ou de la ligne de commande.

Configurer ArcGIS Notebook Server après l’installation

Une fois l’installation de ArcGIS Notebook Server terminée, exécutez l’utilitaire de post-installation pour installer l’image de conteneur Windows. Inscrivez-vous au programme de test des fonctionnalités bêta ArcGIS Enterprise de la Esri Early Adopter Community (EAC) pour télécharger l’image de conteneur Windows. Exécutez la procédure suivante pour chaque ordinateur sur lequel vous avez installé ArcGIS Notebook Server.

1. Ouvrez la fenêtre d’invite de commande en tant qu’administrateur.
2. Modifiez les répertoires pour utiliser le dossier d’outils de ArcGIS Notebook Server. Par défaut, le chemin est C:\Program Files\ArcGIS\NotebookServer\tools\PostInstallUtility.
3. Déterminez si Mirantis Container Runtime est actif sur l’ordinateur en exécutant la commande suivante :

   PostInstallUtility.bat -d

4. Si Mirantis Container Runtime n’est pas installé, installez et configurez-le en suivant les instructions ci-dessus.
5. Exécutez la commande suivante :

   > PostInstallUtility.bat -l <path of .tar.gz Docker image>

Créer un site ArcGIS Notebook Server

Après avoir installé ArcGIS Notebook Server et configuré l’image de conteneur Windows à l’aide de l’utilitaire de post-installation, créez un site de serveur en suivant les instructions de la rubrique Créer un site ArcGIS Notebook Server.

Remarque :

Si vous prévoyez de déployer ArcGIS Notebook Server sur plusieurs machines, lisez la section Remarques liées aux répertoires et au configuration store de Notebook Server ci-dessous avant de créer un site.

Remarques liées aux répertoires et au configuration store de Notebook Server

Si vous envisagez de déployer ArcGIS Notebook Server sur plusieurs machines, le répertoire de contenu et le configuration store doivent utiliser un répertoire partagé référencé par un chemin UNC (Universal Naming Convention). Le répertoire d’espace de travail doit toujours utiliser un chemin UNC configuré comme un réseau apparié avec une lettre de lecteur correspondante sur toutes les machines qui participent au site, et l’utiliser comme répertoire d’espace de travail.

Pour connaître les instructions de configuration d’un lecteur réseau apparié, reportez-vous à la rubrique Configurer un lecteur réseau apparié pour le répertoire d’espace de travail.

Activer une entité de conteneur Windows pour Notebook Server

Après avoir créé le site, optez pour l’utilisation de ArcGIS Notebook Server avec des conteneurs Windows en procédant comme indiqué ci-après. Une fois le site ArcGIS Notebook Server créé, connectez-vous à l’API d’administration afin de vérifier que le site est configuré pour utiliser des conteneurs Windows.

1. Connectez-vous au répertoire d’administration de ArcGIS Notebook Server en tant qu’administrateur.
2. Cliquez sur System (Système) > Properties (Propriétés).
3. Cliquez sur Update properties (Mettre à jour les propriétés).
4. Mettez à jour la propriété useWindowsContainers en la définissant sur true.
5. Cliquez sur Update properties (Mettre à jour les propriétés) pour enregistrer les modifications.
6. Une fois que Notebook Server a redémarré et que le répertoire d’administration est accessible, cliquez sur Notebook > Runtimes > Restore Factory Runtimes (Restaurer les runtimes d’usine).

   https://notebook.domain.com:11443/arcgis/admin/notebooks/runtimes/restore

7. Cliquez sur Restore Factory Runtimes (Restaurer les runtimes d’usine) pour mettre à jour les runtimes Notebook Server Standard et Advanced et faire en sorte qu’ils utilisent les images de conteneur Windows.

Installer et configurer ArcGIS Web Adaptor avec ArcGIS Notebook Server

Une fois votre site ArcGIS Notebook Server créé, vous devez installer ArcGIS Web Adaptor et l’inscrire auprès de ArcGIS Notebook Server. Pour plus d’informations, reportez-vous à la rubrique Installer et configurer ArcGIS Web Adaptor avec ArcGIS Notebook Server.

Installer et configurer les exemples de données ArcGIS Notebook Server

Des données d’exemple ArcGIS Notebook Server sont requises pour les exemples de notebooks gérés par Esri inclus avec ArcGIS Notebook Server. Pour plus d’informations, reportez-vous à la rubrique Installer et configurer des données d’exemple ArcGIS Notebook Server.

Configurer Notebook Server avec un portail ArcGIS Enterprise

Après avoir installé ArcGIS Notebook Server, l’avoir configuré avec Mirantis Container Runtime, avoir créé un site de serveur et avoir inscrit ce dernier auprès d’un adaptateur Web, vous pouvez configurer le site avec un portail ArcGIS Enterprise. Pour plus d’informations, reportez-vous à la rubrique Configurer ArcGIS Notebook Server avec le portail.

Joindre des machines supplémentaires au site ArcGIS Notebook Server

ArcGIS Notebook Server prend en charge les sites comprenant plusieurs machines. Sur un site à plusieurs machines, toutes les machines doivent avoir la même configuration, avec le même système d’exploitation, une configuration de Mirantis Container Runtime identique et un lecteur réseau apparié avec la même lettre de lecteur pour le répertoire d’espace de travail. Pour plus d’informations, reportez-vous à la section Installer et configurer un site à plusieurs machines dans la rubrique Joindre des machines supplémentaires à un site ArcGIS Notebook Server.

Configurer un lecteur réseau apparié pour le répertoire d’espace de travail

Ce traitement facultatif est requis uniquement si vous prévoyez de configurer un site Notebook Server comprenant plusieurs machines.

1. Créez un partage UNC pour le répertoire d’espace de travail ArcGIS Notebook Server sur une machine distincte, accessible par Notebook Server.

   Remarque :

   Ce répertoire doit disposer d’un accès en lecture et en écriture sur le compte d’exécution de ArcGIS Notebook Server Windows. Il est recommandé de créer un partage UNC pour le répertoire d’espace de travail ArcGIS Notebook Server sur une machine distincte de la machine qui participe au site ArcGIS Notebook Server. Il existe un problème connu concernant les partages SMB créés sur la même machine que Notebook Server qui se déconnectent au redémarrage de la machine.

2. Sur la machine Notebook Server, ouvrez une fenêtre PowerShell en tant qu’administrateur.
3. Enregistrez votre mot de passe de compte utilisateur ArcGIS Notebook Server sous forme de chaîne sécurisée en vue d’une utilisation ultérieure à l’aide de la commande suivante :

   $password = ConvertTo-SecureString '<password>' -AsPlainText -Force

4. Ajoutez la prise en charge des identifiants de connexion aux fonctions PowerShell :

   $credential = New-Object System.Management.Automation.PSCredential('<domain\username>', $password)

5. Montez le dossier avec l’indicateur Persistent (Persistant) défini :

   New-SmbGlobalMapping -Persistent $true -RemotePath <shared folder path> -Credential $credential -LocalPath <unassigned drive letter>:

6. Répétez les étapes 2 à 5 sur toutes les machines qui participent au site ArcGIS Notebook Server et attribuez la même lettre de lecteur au lecteur apparié sur toutes les machines.
7. Utilisez le lecteur de réseau partagé créé à l’étape précédente pour configurer le répertoire d’espace de travail à la création du site ArcGIS Notebook Server.

Étendre un runtime de notebook

Pour plus d’informations, reportez-vous à la rubrique Étendre un runtime de notebook.

Après avoir suivi les étapes de cette rubrique, vous disposez maintenant d’un déploiement ArcGIS Notebook Server configuré avec des conteneurs Windows.