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 se décline en deux éditions. Docker Desktop et Mirantis Container Runtime (anciennement Docker Engine-Enterprise).
| 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 sur Windows version 4.4.4 ou ultérieure | Linux | Hyper-V requis |
Windows Server 2022 Standard et Datacenter | Mirantis Container Runtime version 20.10 ou ultérieure | Version bêta Windows | Hyper-V est facultatif. Le nombre maximal de conteneurs pouvant s’exécuter avec un isolement Hyper-V sur Windows Server 2022 Standard est limité. Consultez la FAQ Windows pour plus d’informations. |
Pour ArcGIS Notebook Server 11.0, Docker Desktop est l’édition appropriée à utiliser avec Windows. Ce logiciel vous permet d’utiliser ArcGIS Notebook Server.
Remarque :
À la version ArcGIS Notebook Server 11.0, ArcGIS Notebook Server prend en charge Mirantis Container Runtime pour Windows Server en tant que version bêta. Pour cette version, il est recommandé de n’utiliser ArcGIS Notebook Server avec Mirantis Container Runtime qu’à des fins de test.
Pour plus d’informations sur l’utilisation de Mirantis Container Runtime avec ArcGIS Notebook Server dans la version 11.0, reportez-vous à Docker et ArcGIS Notebook Server.
Remarque :
Docker et Mirantis Container Runtime sont des composants logiciels tiers et cette rubrique ne fournit pas nécessairement le processus complet permettant de les installer. Reportez-vous aux sites Docker et Mirantis Container Runtime pour plus d’informations sur le processus d’installation de ces composants.
Installation de Docker Desktop
Procédez comme suit pour installer Docker Desktop :
- 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 2022 ou 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 4.4.4 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, 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 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.
Modifier 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.
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é à 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.
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.
Installer Mirantis Container Runtime sur Windows
Attention :
Mirantis Container Runtime sur Windows est pris en charge en tant que version bêta pour ArcGIS Notebook Server sur Windows Server 2022. Dans la version bêta, il se peut que ces fonctionnalités aient rencontré des problèmes de performances ou de qualité ; elles ne sont alors pas prises en charge par le support technique Esri. N’activez pas Hyper-V, car cette fonctionnalité n’est pas nécessaire pour l’installation de Mirantis Container Runtime sur Windows Server 2022. N’activez pas la fonctionnalité Containers (Conteneurs) sur votre serveur local avant d’installer Mirantis Container Runtime.- Désinstallez les versions précédentes de Docker installées sur votre machine.
- Suivez les étapes indiquées dans la rubrique Installer MCR sur Windows Server fournie par Mirantis.
- Vérifiez que Mirantis Container Runtime est correctement installé et qu’il a été démarré en exécutant la commande suivante :
docker run hello-world:nanoserver - Ceci fait, procédez comme suit pour configurer Mirantis Container Runtime.
Configurer Mirantis Container Runtime
Procédez comme suit pour configurer Mirantis Container Runtime sur votre machine.
- Activez le port 2375 pour pouvoir utiliser l’API distante Docker.
Ce port sera uniquement utilisé en interne par ArcGIS Notebook Server et doit être protégé de tout usage externe.
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://0.0.0.0:2375 -H npipe://" - Ouvrez une fenêtre PowerShell en tant qu’administrateur et exécutez la commande suivante :
Restart-Service docker
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 ?