Pratiques conseillées pour les administrateurs

Les pratiques conseillées et les rappels pour les administrateurs de ArcGIS Notebook Server sont répertoriés ci-dessous.

Gérer votre déploiement

Cette section couvre les pratiques conseillées pour gérer votre déploiement ArcGIS Notebook Server.

Ressources machine

Lorsqu’un notebook s’exécute, le conteneur dans lequel il s’exécute consomme des ressources sur le site ArcGIS Notebook Server. Le runtime standard nécessite 1 cœur de processeur et 4 Go de mémoire, tandis que le runtime avancé nécessite 2 cœurs de processeur et 6 Go de mémoire. Assurez-vous que le site de votre serveur dispose d’une capacité adéquate sur sa machine pour prendre en charge chaque membre du portail disposant de privilèges de notebook.

Fédération

ArcGIS Notebook Server doit être fédéré à un portail pour fonctionner. Vous ne pouvez pas avoir un site ArcGIS Notebook Server autonome.

N’annulez la fédération de votre site ArcGIS Notebook Server que si cela est absolument nécessaire. Annuler la fédération d’un site ArcGIS Notebook Server a des conséquences sérieuses et irréversibles pour votre serveur de contenu et vos notebooks.

Ports

Ouvrez et protégez le port 11443 sur votre machine ArcGIS Notebook Server. L’adaptateur web a besoin de communiquer avec ce port et la totalité du trafic doit passer par l’adaptateur web.

ArcGIS Notebook Server nécessite un accès au port 7443 sur la machine hébergeant le portail ArcGIS Enterprise auquel il est fédéré. Le port 7443 n’a pas besoin d’être ouvert sur la machine ArcGIS Notebook Server.

Par défaut, des conteneurs Docker sont créés sur les ports 30001 à 31000. Ces ports ne sont pas exposés en dehors de la machine ArcGIS Notebook Server et seul ArcGIS Notebook Server doit communiquer avec eux.

Mise en réseau

Le composant Docker Engine de votre site ArcGIS Notebook Server assure la mise en réseau pour le code dans ArcGIS Notebooks afin d’accéder à votre réseau. En cas de problèmes de connectivité dans un notebook en cours d’exécution, vérifiez le réseau Docker à l’aide de l’outil de commande docker network comme suit :

• Utilisez la commande docker network create pour recréer votre réseau si nécessaire.
• Si vous recréez votre réseau, réaffectez-le aux conteneurs de votre site à l’aide de la commande docker network connect.

Pour afficher la liste de tous les conteneurs s’exécutant sur votre site, utilisez la commande docker ps -a.

Journaux

Vous pouvez utiliser les journaux de ArcGIS Notebook Server pour résoudre les problèmes liés à l’exécution de ArcGIS Notebooks. Interrogez les journaux à l’aide du répertoire administrateur ArcGIS Notebook Server. Vous pouvez définir différents niveaux de consignation afin d’afficher divers types d’informations.

Utilisateurs Linux

Exécutez les diagnostics avant de terminer l’installation.

ArcGIS Notebook Server ne doit pas s’exécuter en tant que racine.

Contrôle d’accès

Cette section explique comment contrôler l’accès aux composants de votre déploiement ArcGIS Notebook Server.

Accès au portail

Déterminez quels utilisateurs disposent de privilèges de notebook sur votre portail ArcGIS Enterprise. Chaque membre qui crée son premier notebook lance son propre conteneur Docker pour notebooks. Cette opération importante utilise les ressources et la mémoire de votre machine serveur.

Par défaut, seuls les administrateurs du portail disposent de privilèges pour créer et modifier des notebooks, ce qui n’est pas le cas des éditeurs. Créez un ou plusieurs rôles personnalisés sur le portail afin d’attribuer des privilèges de notebook à des membres autres que les administrateurs. Restez cependant prudent quant au choix des personnes à qui est attribué un rôle incluant ces privilèges.

Accès au système

Le dossier arcgisworkspace créé lors de l’installation doit faire l’objet d’un contrôle d’accès strict. Seuls l’utilisateur ayant installé ArcGIS Notebook Server et les administrateurs système peuvent y accéder initialement. Ce dossier contient les espaces de travail privés de vos utilisateurs, qui stockent des données auxquelles les autres utilisateurs ne doivent pas pouvoir accéder. Cet emplacement stocke également des informations de jeton de portail auxquelles les conteneurs Docker peuvent accéder.

Par défaut, ce répertoire se trouve dans <ArcGIS Notebook Server install directory>/usr/directories/arcgisworkspace.

Notebooks partagés

Lorsque vous ouvrez un notebook partagé en tant qu’administrateur, vous disposez des privilèges administratifs sur le notebook, notamment la possibilité d’exécuter toutes les cellules. Ouvrez uniquement les notebooks provenant d’une source fiable, et exécutez chaque cellule uniquement après en avoir vérifié le contenu.

Personnaliser votre déploiement

ArcGIS Notebook Server vous permet de créer un remplacement pour le modèle de notebook par défaut de votre organisation.

Modifier le modèle de notebook par défaut

ArcGIS Notebook Server comprend un modèle de notebook par défaut apparaissant lorsqu’un nouveau notebook est ouvert. En tant qu’administrateur, vous pouvez ignorer ce modèle par défaut et le remplacer par un fichier de notebook personnalisé pour votre organisation.

Pour ce faire, créez le notebook que vous souhaitez utiliser comme modèle par défaut de votre organisation et enregistrez-le pour remplacer le modèle de notebook existant, situé dans <ArcGIS Notebook Server install directory>/framework/etc/ipynb_defaults/default_new.ipynb. Le notebook doit être nommé default_new.ipynb s’il doit être utilisé comme modèle de notebook par défaut ArcGIS Notebook Server.