Les étapes ci-dessous expliquent comment télécharger, installer et configurer le logiciel d’allocation de conteneurs Docker requis par ArcGIS Notebook Server. Reportez-vous à la rubrique Docker et ArcGIS Notebook Server pour en savoir plus sur Docker et sur son utilisation dans ArcGIS Notebook Server.
Télécharger et installer Docker
L’édition de Docker requise pour exécuter ArcGIS Notebook Server sur Windows est Docker Desktop Community. Elle est accessible via l’application Docker Desktop for Windows. Pour installer Docker sur votre machine, procédez comme suit.
- Vérifiez que Hyper-V est installé sur la machine Windows en recherchant l’application Hyper-V Manager. Si tel n’est pas le cas, installez-le avant de continuer. Consultez la documentation Microsoft suivante pour savoir comment procéder :
- Si le système d’exploitation est Windows Server 2019, consultez la rubrique Install the Hyper-V role on Windows Server.
- Si le système d’exploitation est Windows 10, consultez la rubrique Install Hyper-V on Windows 10.
ArcGIS Notebook Server requiert Docker Desktop pour Windows (version 3.0.0 ou ultérieure).
- Dans un navigateur, accédez à la page de téléchargement Docker Desktop (Windows) dans le magasin Hub Docker.
- Connectez-vous à votre compte Docker Hub existant ou créez un compte.
- Téléchargez le logiciel Docker Desktop.
- Double-cliquez sur Docker for Windows Installer pour exécuter le programme d’installation.
- Dans la boîte de dialogue Configuration du programme d’installation, n’autorisez pas Docker à utiliser les conteneurs Windows puisque ArcGIS Notebook Server requiert des conteneurs Linux.
- Fermez le programme d’installation une fois qu’il est terminé.
- Cliquez sur le bouton Docker Desktop dans le menu Start (Démarrer) pour démarrer Docker.
- Vérifiez que Docker a démarré à l’aide d’une des méthodes suivantes :
- Vérifiez le statut de l’icône Docker dans la barre d’état système de Windows (généralement en bas à droite de l’écran).
- Ouvrez la fenêtre d’invite de commande et exécutez les commandes suivantes :
docker version docker run hello-world
Configurer les paramètres Docker
Une fois Docker installé sur votre machine, modifiez les paramètres décrits ci-dessous.
Utiliser le port 2375
Vous allez utiliser Docker Remote API, qui implique l’utilisation du port 2375. Ce port sera uniquement utilisé en interne par ArcGIS Notebook Server et doit être protégé de tout usage externe.
- Cliquez avec le bouton droit sur le bouton Docker dans la barre d’état système de Windows et sélectionnez Settings (Paramètres).
- Sur la page General (Général), sélectionnez Expose daemon on tcp://localhost:2375 without TLS (Exposer le démon sur tcp://localhost:2375 sans TLS).
Un avertissement de sécurité peut apparaître. Vérifiez que votre administrateur système sait que ce port est utilisé en interne et qu’aucun usage externe ne doit être autorisé sur le port.
Définir le partage de fichiers
Le conteneur Docker doit avoir accès au lecteur local qui sera configuré comme répertoire d’espace de travail ou à un répertoire de données personnalisées pour le serveur de notebooks. Suivez la procédure ci-après au cours de l’installation initiale, puis répétez-la chaque fois que les identifiants de connexion de votre compte Run As (Exécuter en tant que) changent, ou si le compte Run As (Exécuter en tant que) lui-même change. Si vous créez un compte au cours de l’installation de ArcGIS Notebook Server, vous êtes ramené à cette étape.
- Cliquez avec le bouton droit sur le bouton Docker dans la barre d’état système de Windows et sélectionnez Settings (Paramètres).
- Dans le menu des paramètres, cliquez sur Resources (Ressources) > File sharing (Partage de fichiers).
- Ajoutez le chemin du lecteur ou du répertoire à utiliser pour votre répertoire d’espace de travail ou de données personnalisées ArcGIS Notebook Server.
Remarque :
Si aucun répertoire d’espace de travail ou répertoire de données personnalisées n’existe actuellement (par exemple, C:\arcgisnotebookserver), créez un site ArcGIS Notebook Server ou inscrivez un répertoire de données avant d’accomplir cette étape.
Remarque :
Docker for Windows prend uniquement en charge les répertoires locaux sur Windows à partager avec des conteneurs Linux.
Limiter les ressources avancées
Vous pouvez utiliser le volet des paramètres de Docker pour limiter les ressources disponibles pour ArcGIS Notebook Server et les conteneurs qui s’exécutent sur votre site de serveur.
- Cliquez avec le bouton droit sur le bouton Docker dans la barre d’état de votre système Windows et sélectionnez Settings (Paramètres). Dans le menu des paramètres, cliquez sur Resources (Ressources) > Advanced (Avancé).
- Vous pouvez également modifier les paramètres suivants :
- CPUs : nombre de cœurs de processeur disponibles pour les conteneurs sur votre machine. Par défaut, cette option est définie sur deux cœurs. Vous pouvez modifier cette valeur en fonction des ressources disponibles sur la machine et des limites de processeur définies pour les runtimes de notebooks.
- Memory : quantité de mémoire disponible pour les conteneurs sur votre machine. Par défaut, cette option est définie sur 2 Go. Portez cette valeur à 6 Go au minimum. Vous pouvez juger utile d’augmenter cette valeur en fonction des ressources disponibles sur la machine et des limites de mémoire définies pour les runtimes de notebooks.
- Swap : quantité d’espace disque que les conteneurs peuvent utiliser comme mémoire si la limite supérieure est atteinte.
- Disk image size (Taille d’image disque) : taille de l’image disque. Après avoir examiné cette valeur, modifiez-la comme il convient si l’installation d’images de conteneur Docker pour Notebooks se solde par une erreur pour insuffisance d’espace disque.
- Disk image location (Emplacement de l’image disque) : répertoire de stockage des conteneurs et des images.
Remarque :
Reprenez cette étape chaque fois que vous modifiez les ressources en mémoire et en processeur configurées pour les runtimes de notebooks. - Une fois que vous êtes satisfait des limites de ressources que vous avez définies, cliquez sur Apply.
Une fois le composant Docker installé, redémarrez votre machine. Vous devez redémarrer la machine chaque fois que vous installez ou mettez à niveau le composant Docker.
Vous êtes maintenant prêt à installer ArcGIS Notebook Server sur votre machine.
Vous avez un commentaire à formuler concernant cette rubrique ?