Configurer les services de notebook

Vous pouvez utiliser les services de notebook pour créer et automatiser les processus de notebook.

Licence :

Cette fonctionnalité est disponible à deux niveaux de licence :

• Une licence ArcGIS Notebook Services est fournie avec la licence ArcGIS Enterprise on Kubernetes. Cette licence permet aux membres de l’organisation de créer des notebooks à l’aide du runtime ArcGIS Notebook Python 3 Standard et d’automatiser les processus de notebook à l’aide de tâches planifiées, de webhooks et d’outils Web.
• Une licence ArcGIS Notebook Services Advanced est disponible sous forme de fonctionnalité Premium qui donne accès au runtime ArcGIS Notebook Python 3 Advanced avec des fonctionnalités ArcPy supplémentaires qui vont au-delà de ce qu’offre la licence ArcGIS Notebook Services.

Remarque :

Pour prendre en charge Notebook Services, la configuration des proxys inverses externes ou des équilibreurs de charge doit être définie de telle sorte qu’ils puissent transmettre le trafic du WebSocket aux cibles dorsales et que les sessions restent ouvertes 10 minutes.

Présentation des services de notebook

Les services de notebook offrent une interface Web polyvalente pour notebooks Python qui permet d’analyser les données géospatiales. Grâce aux notebooks, vous pouvez réaliser des analyses, automatiser des processus et visualiser immédiatement les données et les résultats d’analyse dans un contexte géographique.

Les notebooks constituent un environnement moderne efficace associant code, visualisations et cartes à la volée, et outils de données. Dans l’éditeur de notebooks, vous pouvez écrire, documenter et exécuter du code Python à partir d’un même emplacement.

Avant d’activer les services de notebook, vérifiez que le quota de ressources et le nombre de nœuds worker alloués par votre administrateur suffisent à prendre en charge cette fonctionnalité Premium.

Configurer les services de notebook

Les étapes de configuration suivantes peuvent entraîner la modification de votre déploiement ArcGIS dans votre organisation. Examinez-les attentivement avant de continuer.

Les Notebook Services nécessitent que le pod runAsUser disposent des autorisations de lecture et d’écriture sur le partage réseau associé. Pour certains fournisseurs, cela peut nécessiter d’accorder ces autorisations à d’autres utilisateurs, tandis que dans d’autres instances, l’emplacement partagé peut être mis à jour pour autoriser l’ID d’utilisateur par défaut (117932853) à être propriétaire du répertoire parent et de tout sous-répertoire/fichier. Si d’autres utilisateurs disposent de l’accès en lecture/écriture, les bonnes plages IP doivent être utilisées comme contrôle de sécurité sur la configuration NFS. Pour les agrégats qui attribuent aléatoirement les ID d’utilisateur pendant l’admission/la planification du pod, l’ID d’utilisateur doit être défini sur une valeur statique et les autorisations adaptées en conséquence.

Activer les services de notebook

Pour activer les services de notebook, vous devez configurer un espace de travail de notebook et activer la fonctionnalité dans ArcGIS Enterprise Manager.

1. Dans ArcGIS Enterprise Manager, cliquez sur le bouton Capabilities (Fonctionnalités) dans la barre latérale.

   La page des fonctionnalités apparaît.

2. Activez le bouton bascule Notebook services (Notebook Services).

   La boîte de dialogue Configure workspace (Configurer l’espace de travail) apparaît et vous invite à spécifier les valeurs nécessaires. L’espace de travail permet de stocker les fichiers associés aux notebooks de chaque membre de l’organisation.

3. Fournissez les informations nécessaires :
   • • Volume type (Type de volume) : sélectionnez Dynamic (Dynamique) ou Static (Statique) pour indiquer la façon dont vous souhaitez provisionner un volume persistant pour l’espace de travail. Utilisez Static (Statique) lorsque la demande de volume persistant (PVC) doit être liée à un volume persistant (PV) existant. Utilisez Dynamic (Dynamique) lorsqu’un nouveau volume persistant doit être provisionné via la classe de stockage spécifiée. Pour en savoir plus, prenez connaissance des considérations concernant le provisionnement dynamique et le provisionnement statique.

       Remarque :

       Pour cet espace de travail, le volume persistant doit être de type FileSystem et prendre en charge le mode d’accès ReadWriteMany (RWX). Avant de configurer un espace de travail de notebook, vérifiez que le volume persistant que vous allouez à cet espace de travail prend en charge le mode d’accès RWX. De plus, pour assurer la prise en charge du volume persistant, vous pouvez être amené à installer un pilote de prise en charge dans votre cluster Kubernetes

     • Volume name (Nom du volume) : si vous sélectionnez Static (Statique), vous devez fournir un nom de volume.
     • Storage class name (Nom de la classe de stockage) : attribuez à la classe de stockage le nom de votre choix ou, si vous avez déjà défini une classe de stockage, nommez la classe de stockage pour le volume.

       Remarque :

       Le nom de la classe de stockage est requis pour l’option Dynamic (Dynamique) et facultative pour Static (Statique).

       Remarque :

       Lors de la liaison à un volume persistant existant pour lequel aucune classe de stockage n’a été définie, laissez le nom de la classe de stockage vide. Si une classe de stockage par défaut est configurée dans le cluster, le contrôleur d’admission DefaultStorageClass ajoute la classe de stockage par défaut et empêche la liaison de la réclamation de volume persistant. En pareil cas, les administrateurs doivent ajouter la spécification de classe de stockage au volume existant ou supprimer la configuration de la classe de stockage par défaut.

     • Size (GiB) (Taille [Gio]) : définissez la taille du volume persistant. La taille minimale est de 100 Gio. La valeur doit correspondre à la taille du volume persistant existant en cas de liaison statique. Si la valeur est supérieure à la taille du volume persistant, la réclamation de volume persistant ne pourra pas être liée au volume persistant.

       Remarque :

       Un seul espace de travail de notebook peut être configuré pour votre organisation. Sa taille de stockage est limitée à la valeur spécifiée au moment où il a été créé. Veillez à attribuer une taille suffisante à l’espace de travail de façon à répondre à vos besoins actuels et futurs.

     • Cliquez sur Save (Enregistrer).

   Un message s’affiche pour indiquer que le processus d’activation peut prendre du temps.

   Une demande d’activation des services de notebook est envoyée. Ce processus validera les conditions préalables et activera les ressources de prise en charge. Un service d’automatisation des notebooks démarre automatiquement.

Si l’activation de la fonctionnalité échoue, répétez les étapes ci-dessus pour vous assurer que l’espace de travail a été configuré, que la licence des services de notebook est valide et disponible et que les services système ont été démarrés. Passez en revue les journaux pour identifier les exigences pour cette capacité.

Vous pouvez éventuellement déployer un deamonSet pour précharger les images des services de notebook. Cela contribuera à améliorer le temps nécessaire pour ouvrir un notebook pour la première fois. Le temps d’expiration défini pour le chargement initial d’un notebook est d’1 minute.

Les services de notebook sont maintenant configurés. Vous pouvez commencer à utiliser des notebooks dans votre organisation. Découvrez comment créer un notebook et comment publier un notebook en tant qu’outil Web.

Par ailleurs, découvrez comment ajuster les paramètres pour la fonctionnalité de services de notebook.

Paramètres des services de notebook

Après avoir activé les services de notebook, vous pouvez consulter et mettre à jour les paramètres associés tels que les ressources de prise en charge pour les runtimes applicables, la taille de WebSocket, le nombre maximal d’instantanés par élément de notebook, etc.

La fonctionnalité de services de notebook comprend trois onglets principaux qui vous permettent de consulter ou mettre à jour les paramètres : Overview (Vue d’ensemble), Properties (Propriétés) et Runtimes.

• Overview (Vue d’ensemble) : déterminez le statut de votre service d’automatisation des notebooks, le nombre de déploiements de notebook en cours d’exécution et la classe de stockage affectée à l’espace de travail de notebook dédié.
• Properties (Propriétés) : gérez les limites associées aux déploiements de notebook interactifs et automatisés.
• Runtimes : consultez et mettez à jour les paramètres des runtimes de services de notebook disponibles.

Consulter et mettre à jour les propriétés

Les propriétés suivantes peuvent être consultées et mises à jour dans ArcGIS Enterprise Manager :

• Web Socket Size (MB) (Taille du socket Web [Mo]) : taille maximale (en mégaoctets) d’un paquet transmis entre le serveur et les navigateurs client via le protocole WebSocket. L’utilisation de WebSocket vise à favoriser une communication bidirectionnelle efficace et sécurisée avec les clients. La valeur par défaut de cette propriété est 16 Mo. Vous pouvez être amené à élever cette limite si un notebook doit transmettre un volume de données particulièrement important au site du serveur.
• Idle notebook threshold (minutes) (Seuil pour les notebooks inactifs (minutes)) : cette propriété régit la fermeture des notebooks inactifs. Les notebooks ouverts mais inactifs pendant un certain laps de temps (exprimé en minutes) sont automatiquement fermés. Le noyau du notebook s’est arrêté. La valeur par défaut est 7 minutes.
• Empty deployment threshold (Seuil pour les déploiements vides) : cette propriété définit la durée pendant laquelle un déploiement de notebooks peut rester ouvert (en minutes) sans exécuter de notebook actif. Lorsque cette valeur est atteinte, le conteneur se ferme automatiquement. La valeur par défaut est 60 minutes. Comme le seuil de notebooks inactifs, vous pouvez réduire cette valeur pour préserver les ressources.
• Maximum snapshots per notebook item (Nombre maximal d’instantanés par élément de notebook) : cette propriété limite le nombre d’instantanés autorisés pour un élément de notebook. La valeur par défaut est 5.

Pour consulter et mettre à jour les propriétés, procédez comme suit.

1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
2. Cliquez sur la page Capabilities (Fonctionnalités).
3. Sur la fiche Notebook Services, cliquez sur Settings (Paramètres).
4. Cliquez sur la page Properties (Propriétés).

   Si vous modifiez l’une des valeurs des paramètres, le bouton Save (Enregistrer) devient disponible.

5. Cliquez sur Save (Enregistrer) pour conserver vos mises à jour.

Consulter et mettre à jour les runtimes

En tant qu’administrateur, vous pouvez mettre à jour le processeur et la mémoire maximum disponibles par conteneur en modifiant les ressources que chaque runtime de notebook utilise par défaut. Si plusieurs utilisateurs créent des notebooks simultanément, vous pouvez surveiller l’utilisation et ajuster ces paramètres selon les besoins à l’aide d’ArcGIS Enterprise Manager.

Les aspects suivants des runtimes peuvent être consultés et mis à jour dans ArcGIS Enterprise Manager :

Pour consulter et mettre à jour les valeurs des runtimes, procédez comme suit.

1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
2. Cliquez sur la page Capabilities (Fonctionnalités).
3. Sur la fiche Notebook Services, cliquez sur Settings (Paramètres).
4. Cliquez sur la page Runtimes.

   Si vous modifiez l’une des valeurs des paramètres, le bouton Save (Enregistrer) devient disponible.

5. Cliquez sur Save (Enregistrer) pour conserver vos mises à jour.