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.
Éditions de Docker
Docker est disponible en tant que Docker Desktop.
| Système d’exploitation | Édition Docker | Type d’image d’environnement de notebook (conteneur) | Configuration supplémentaire |
|---|---|---|---|
Windows Server 2019 Standard et Datacenter Windows Server 2022 Standard et Datacenter | Docker Desktop on Windows version 4.24.2 | Linux | Hyper-V requis |
Remarque :
Docker est un composant logiciel tiers et cette rubrique ne fournit pas nécessairement le processus complet permettant de l’installer. Reportez-vous au site Docker pour plus d’informations sur le processus d’installation.
Installation de Docker Desktop
Procédez comme suit pour installer Docker Desktop :
- Vérifiez que Hyper-V est installé sur votre 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 votre système d’exploitation est Windows Server 2022 ou Windows Server 2019, consultez la rubrique Installer le rôle Hyper-V sur Windows Server.
- Si votre système d’exploitation est Windows 10, consultez la rubrique Installer Hyper-V sur Windows 10.
ArcGIS Notebook Server requiert Docker Desktop pour Windows (version 4.24.2).
- 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, décochez la case Use WSL2 instead of Hyper-V (Utiliser WSL2 au lieu de Hyper-V).
- 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 Command Prompt (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.
Configurer les paramètres généraux
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écochez la case Use the WSL2 based engine (Utiliser le moteur WSL2) si elle est cochée.
Modifier l’emplacement d’installation par défaut de l’image Docker
Pour modifier l’emplacement d’installation par défaut de l’image Docker, procédez comme suit :
- Ouvrez les paramètres Docker Desktop.
- Cliquez sur Resources (Ressources) > Advanced (Avancé).
- Définissez le champ Disk image location sur le chemin du répertoire local choisi sur la machine.
Configurer 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é à ces étapes.
- 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.
Configurer 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é).
- Changez 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 ?