Skip to main content

Installer un moteur de conteneurisation pour ArcGIS Notebook Server

Les étapes ci-dessous expliquent comment télécharger, installer et configurer le logiciel d’allocation de conteneurs requis par ArcGIS Notebook Server. Consultez la rubrique Moteurs de conteneurisation et ArcGIS Notebook Server pour en savoir plus sur les moteurs de conteneurisation et leur utilisation dans ArcGIS Notebook Server.

Télécharger et installer un moteur de conteneurisation

Il existe deux moteurs de conteneurisation disponibles pour les systèmes Linux : Docker Engine et Mirantis Container Runtime.

Si vous utilisez Ubuntu ou Red Hat Enterprise Linux Server, vous pouvez utiliser l’édition Docker de votre choix.

Moteur de conteneurisation

Système d’exploitation

Docker Engine Community Edition 29.2.0 ou version ultérieure

Remarque :

Si vous utilisez Docker Engine 29 ou une version ultérieure et que ce moteur a été mis à niveau à partir d’une version précédente, mettez à jour /etc/docker/daemon.json pour activer l’image store containerd. Pour plus d’informations, consultez l’étape 4 de la section Configurer les paramètres et environnements de Docker.

Ubuntu Server LTS 24.04.3

Ubuntu Server LTS 22.04.5

Red Hat Enterprise Linux Server 8 mise à jour 10

Red Hat Enterprise Linux Server 9 mise à jour 7

Rocky Linux 8 mise à jour 10

Rocky Linux 9 mise à jour 7

AlmaLinux 8 mise à jour 10

AlmaLinux 9 mise à jour 7

Mirantis Container Runtime 25.0.15 ou version ultérieure

Remarque :

Consultez la matrice de compatibilité Mirantis Container Runtime 25.0 pour obtenir les informations les plus récentes.

Ubuntu Server LTS 22.04.3

Ubuntu Server LTS 24.04.2

Red Hat Enterprise Linux Server 8 mise à jour 10

Red Hat Enterprise Linux Server 9 mise à jour 7

Oracle Linux 9 mise à jour 7

Rocky Linux 8 mise à jour 10

Rocky Linux 9 mise à jour 7

SUSE Linux Enterprise Server (SLES) 15 SP6

Mirantis Container Runtime

ArcGIS Notebook Server sous Windows avec Mirantis Container Runtime prend en charge les systèmes d’exploitation suivants :

Système d’exploitation

Moteur de conteneurisation

Configuration supplémentaire

Windows Server 2022 Standard et Datacenter

Mirantis Container Runtime 25.0.15 ou version ultérieure

Vous pouvez également installer Hyper-V.

Remarque :

Le nombre maximal de conteneurs pouvant s’exécuter avec un isolement Hyper-V sur Windows Server Standard est limité.

Pour plus d’informations, consultez FAQ Windows.

Docker Engine à partir de binaires

ArcGIS Notebook Server sous Windows avec Docker Engine à partir de binaires prend en charge les systèmes d’exploitation et versions de Docker Engine suivants :

Système d’exploitation

Moteur de conteneurisation

Configuration supplémentaire

Windows Server 2025 Standard et Datacenter

Windows Server 2022 Standard et Datacenter

Docker Engine – Community 29.2.0 ou version ultérieure

Vous pouvez également installer Hyper-V.

Remarque :

Le nombre maximal de conteneurs pouvant s’exécuter avec un isolement Hyper-V sur Windows Server Standard est limité.

Pour plus d’informations, consultez FAQ Windows.
Remarque :

Docker étant un composant logiciel tiers, cette rubrique ne détaille pas sa procédure d’installation complète. Examinez et consultez le site Web Docker pour connaître les dernières informations.

Installer Mirantis Container Runtime sur Red Hat Enterprise Linux Server, Ubuntu, SUSE Linux Enterprise Server et Oracle Linux

Pour installer Mirantis Container Runtime, vous devez bénéficier d’une version d’évaluation du logiciel ou d’un abonnement.

  1. Désinstallez les versions précédentes de Docker installées sur votre machine.

    Reportez-vous à la documentation Docker de cette version pour connaître la procédure de désinstallation complète.

  2. Procédez comme indiqué dans le guide d’installation Mirantis Container Runtime de la distribution Linux.

    Remarque :

    Actuellement, Mirantis ne dispose pas d’un guide d’installation distinct pour Rocky Linux, mais le guide d’installation de Red Hat Enterprise Linux peut être utilisé pour une installation sur Rocky Linux.

    Remarque :

    Le document indique les deux méthodes permettant d’installer le logiciel (à partir d’un référentiel Docker ou via un paquetage RPM).

  3. Puisque Docker ne démarre pas automatiquement après l’installation et la configuration, démarrez le démon Docker en exécutant la commande suivante :

$ sudo systemctl start docker

  1. Vérifiez que Docker est correctement installé et qu’il peut accéder aux images de conteneur en exécutant la commande suivante :

$ sudo docker run hello-world

Passez à la section Configurer les paramètres et environnements de Docker, présentée ci-après.

Installer Docker Engine sur Red Hat Enterprise Linux Server, Oracle Linux, Rocky Linux ou AlmaLinux

L’édition Docker Engine est proposée en téléchargement gratuit, mais nécessite un compte Docker.

  1. Désinstallez les versions précédentes de Docker installées sur votre machine.

    Reportez-vous à la documentation Docker de cette version pour connaître la procédure de désinstallation complète.

  2. Pour installer Docker Engine sur RHEL, procédez comme suit.

    Le document indique les deux méthodes permettant d’installer le logiciel (à partir d’un référentiel rpm ou via un paquetage rpm).

    Le démon Docker démarre automatiquement après l’installation.

  3. Vérifiez que Docker est correctement installé et qu’il peut accéder aux images de conteneur en exécutant la commande suivante :

$ sudo docker run hello-world

Passez à la section Configurer les paramètres et environnements de Docker, présentée ci-après.

Installer Docker Engine sur Ubuntu

L’édition Docker Engine est proposée en téléchargement gratuit, mais nécessite un compte Docker.

  1. Désinstallez les versions précédentes de Docker installées sur votre machine.

    Reportez-vous à la documentation Docker de cette version pour connaître la procédure de désinstallation complète.

  2. Suivez les étapes décrites dans Installer Docker Engine sur Ubuntu.

    Le document indique les deux méthodes permettant d’installer le logiciel (à partir d’un référentiel Docker ou via un paquetage DEB).

    Le démon Docker démarre automatiquement après l’installation.

  3. Vérifiez que Docker est correctement installé et qu’il peut accéder aux images de conteneur en exécutant la commande suivante :

$ sudo docker run hello-world

Passez à la section Configurer les paramètres et environnements de Docker, présentée ci-après.

Configurer les paramètres et environnements de Docker

Une fois l’édition Docker appropriée installée sur votre machine, configurez Docker pour l’utiliser avec ArcGIS Notebook Server.

  1. Ajoutez votre compte d’utilisateur du système d’exploitation (ou le compte utilisé pour installer ArcGIS Notebook Server) au groupe nommé docker, qui a été créé automatiquement à l’installation.

$ sudo usermod -aG docker <ArcGIS Notebook Server install account>

  1. Déconnectez-vous et reconnectez-vous au compte d’utilisateur du système d’exploitation pour que les modifications prennent effet.

  2. Vérifiez que vous pouvez exécuter les commandes Docker depuis le compte.

$ docker run hello-world

  1. Si vous utilisez Docker Engine 29 ou une version ultérieure et que ce moteur a été mis à niveau à partir d’une version précédente, mettez à jour /etc/docker/daemon.json pour activer l’image store containerd.

    {
  "features": {
    "containerd-snapshotter": true
  }
}
    Remarque :

    Si daemon.json n’existe pas, créez-le.

  2. Vérifiez que le répertoire /var dispose d’au moins 75 Go d’espace disque.

    Docker utilise le répertoire /var en tant que registre local pour stocker les images de conteneur. Au cours du processus de mise à niveau des versions ultérieures, de nouvelles images seront également copiées dans le répertoire /var. Si l’espace est insuffisant, augmentez l’allocation du répertoire /var ou suivez les sous-étapes ci-après pour changer l’emplacement du répertoire racine de Docker.

    1. Modifiez /etc/docker/daemon.json pour définir data-root sur un répertoire local de votre machine qui dispose d’un espace suffisant.

      Remarque :

      Si ce fichier n’existe pas, créez-le.

      Exemple de chemin :

      {"data-root" : "/data/docker"}

      Voici un exemple de /etc/docker/daemon.json avec des propriétés containerd-snapshotter et data-root :

      {
   "features": {
      "containerd-snapshotter": true
   },
   "data-root" : "/data/docker"
}

    2. Supprimez /var/lib/docker et créez un lien symbolique qui fait référence au chemin spécifié à l’étape précédente.

       $ sudo mkdir /data/docker
   $ sudo rm -rf /var/lib/docker
   $ sudo ln -s /data/docker /var/lib/docker
    1. Cette étape n’est requise que si vous utilisez la version 29 du moteur de conteneurisation. Supprimez /var/lib/containerd et créez un lien symbolique qui fait référence au chemin spécifié à l’étape précédente.
       $ sudo mkdir /data/containerd
   $ sudo rm -rf /var/lib/containerd
   $ sudo ln -s /data/containerd /var/lib/containerd

  3. Redémarrez le service Docker pour appliquer les modifications.

    $ sudo systemctl stop docker.service
$ sudo systemctl stop docker.socket
$ sudo systemctl stop containerd
$ sudo systemctl start containerd
$ sudo systemctl start docker.service
$ sudo systemctl start docker.socket

Vous êtes maintenant prêt à installer ArcGIS Notebook Server sur votre machine.

Configuration requise du moteur de conteneurisation

ArcGIS Notebook Server sous Windows prend en charge Mirantis Container Runtime et Docker Engine à partir de binaires sous forme de moteurs de conteneurisation. Consultez la rubrique Moteurs de conteneurisation et ArcGIS Notebook Server pour en savoir plus sur les moteurs de conteneurisation et leur intégration à ArcGIS Notebook Server.

Il existe deux moteurs de conteneurisation disponibles pour les systèmes Linux : Docker Engine et Mirantis Container Runtime.

Si vous utilisez Ubuntu ou Red Hat Enterprise Linux Server, vous pouvez utiliser l’édition Docker de votre choix.

Moteur de conteneurisation

Système d’exploitation

Docker Engine Community Edition 29.2.0 ou version ultérieure

Remarque :

Si vous utilisez Docker Engine 29 ou une version ultérieure et que ce moteur a été mis à niveau à partir d’une version précédente, mettez à jour /etc/docker/daemon.json pour activer l’image store containerd. Pour plus d’informations, consultez l’étape 4 de la section Configurer les paramètres et environnements de Docker.

Ubuntu Server LTS 24.04.3

Ubuntu Server LTS 22.04.5

Red Hat Enterprise Linux Server 8 mise à jour 10

Red Hat Enterprise Linux Server 9 mise à jour 7

Rocky Linux 8 mise à jour 10

Rocky Linux 9 mise à jour 7

AlmaLinux 8 mise à jour 10

AlmaLinux 9 mise à jour 7

Mirantis Container Runtime 25.0.15 ou version ultérieure

Remarque :

Consultez la matrice de compatibilité Mirantis Container Runtime 25.0 pour obtenir les informations les plus récentes.

Ubuntu Server LTS 22.04.3

Ubuntu Server LTS 24.04.2

Red Hat Enterprise Linux Server 8 mise à jour 10

Red Hat Enterprise Linux Server 9 mise à jour 7

Oracle Linux 9 mise à jour 7

Rocky Linux 8 mise à jour 10

Rocky Linux 9 mise à jour 7

SUSE Linux Enterprise Server (SLES) 15 SP6

Mirantis Container Runtime

ArcGIS Notebook Server sous Windows avec Mirantis Container Runtime prend en charge les systèmes d’exploitation suivants :

Système d’exploitation

Moteur de conteneurisation

Configuration supplémentaire

Windows Server 2022 Standard et Datacenter

Mirantis Container Runtime 25.0.15 ou version ultérieure

Vous pouvez également installer Hyper-V.

Remarque :

Le nombre maximal de conteneurs pouvant s’exécuter avec un isolement Hyper-V sur Windows Server Standard est limité.

Pour plus d’informations, consultez FAQ Windows.

Docker Engine à partir de binaires

ArcGIS Notebook Server sous Windows avec Docker Engine à partir de binaires prend en charge les systèmes d’exploitation et versions de Docker Engine suivants :

Système d’exploitation

Moteur de conteneurisation

Configuration supplémentaire

Windows Server 2025 Standard et Datacenter

Windows Server 2022 Standard et Datacenter

Docker Engine – Community 29.2.0 ou version ultérieure

Vous pouvez également installer Hyper-V.

Remarque :

Le nombre maximal de conteneurs pouvant s’exécuter avec un isolement Hyper-V sur Windows Server Standard est limité.

Pour plus d’informations, consultez FAQ Windows.

Installer Mirantis Container Runtime

Procédez selon les étapes suivantes pour installer Mirantis Container Runtime :

  1. Désinstallez les versions précédentes de Docker installées sur votre machine.

  2. N’activez pas la fonctionnalité Containers (Conteneurs) sur le serveur local avant d’installer Mirantis Container Runtime. Si cette fonctionnalité est déjà activée, désactivez-la sur la machine serveur. Pour plus d’informations, reportez-vous à la rubrique Installer ou désinstaller des rôles, des services de rôle ou des fonctionnalités dans la documentation Microsoft.

  3. Suivez les étapes décrites dans Installer Mirantis Container Runtime sur Windows Server dans la documentation Mirantis pour obtenir et exécuter le script d’installation install.ps1 de Mirantis Container Runtime pour Windows Server.

    Pour exécuter le script d’installation, utilisez le code ci-dessous :

    ./install.ps1

  4. 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

  1. Ceci fait, suivez la procédure indiquée dans Configurer votre composant Docker pour configurer Mirantis Container Runtime.

Installer Docker Engine à partir de binaires

Procédez comme suit pour installer Docker Engine à partir de binaires :

  1. Désinstallez les versions précédentes de Docker installées sur votre machine.

  2. Désactivez la fonctionnalité Conteneurs sur votre serveur local si elle est activée.

    Pour plus d’informations, consultez la documentation Microsoft.

  3. Activez la fonctionnalité Conteneurs Windows en exécutant la commande suivante dans Microsoft PowerShell avec des privilèges d’administration :

Add-WindowsFeature Containers

  1. Suivez les invites pour redémarrer votre machine.

  2. Vérifiez l’installation de la fonctionnalité Conteneurs en exécutant la commande suivante :

Get-WindowsFeature Containers

  1. Suivez les instructions de la section Installer les binaires serveur et client sous Windows disponible dans la documentation Docker.

    Remarque :

    La mise à jour de Docker Engine à partir de binaires n’est pas automatique. Vous devez effectuer manuellement la mise à jour vers les versions plus récentes de Docker. Reportez-vous à la documentation Installer Docker Engine à partir des binaires pour obtenir plus d’informations sur les limitations relatives à l’utilisation de Docker à partir de binaires dans un environnement de production. Bien que cette page recommande d’utiliser Docker Desktop, ArcGIS Notebook Server avec les conteneurs Windows ne prend pas en charge Docker Desktop sous Windows en tant que moteur de conteneurisation.

  2. Ajoutez le chemin d’accès au répertoire Docker (par exemple, C:\Program Files\docker) à la variable d’environnement Path dans la section Variables système.

  3. Vérifiez votre installation et le statut d’exécution du démon Docker en exécutant la commande suivante :

docker version

  1. Ceci fait, suivez la procédure indiquée dans Configurer votre composant Docker pour configurer Docker Engine.

Configurer votre composant Docker

Pour configurer votre composant Docker, procédez comme suit :

  1. Si le compte utilisé pour installer ArcGIS Notebook Server ne fait pas partie du groupe Administrateur, procédez comme suit :

    1. À partir du menu Démarrer de votre ordinateur Windows, ouvrez l’application Computer Management.

    2. Dans la barre latérale gauche, développez l’option Utilisateurs et groupes locaux et ouvrez le dossier Groupes.

    3. Sélectionnez le groupe docker-users dans la liste de groupes et double-cliquez dessus.

      S’il n’existe encore aucun groupe docker-users, créez-en un.

    4. Cliquez sur le bouton Add (Ajouter), recherchez le compte que vous avez utilisé pour installer ArcGIS Notebook Server et sélectionnez-le. Cliquez sur OK pour confirmer.

    5. Cliquez sur OK pour fermer la boîte de dialogue de groupe.

    6. Créez un fichier de configuration dans C:\ProgramData\docker\config\daemon.json afin de définir un groupe de sécurité pour Docker.

    7. Modifiez C:\ProgramData\docker\config\daemon.json pour ajouter le groupe docker-users.

       {
     "group" : "docker-users"
   }

  2. Configurez votre service Docker pour une écoute sur un tube nommé avec la commande suivante :

sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H npipe://"

  1. Redémarrez Docker avec la commande suivante :

    net stop docker
net start docker

  2. Une fois le composant Docker installé, redémarrez la machine.

    Remarque :

    À chaque fois que vous installez ou mettez à niveau le composant Docker, vous devez redémarrer la machine.

Modifier l’emplacement d’installation par défaut de l’image Docker

Si besoin, pour modifier l’emplacement d’installation par défaut de l’image Docker, procédez comme suit :

  1. Modifiez le fichier dans C:\ProgramData\docker\config\daemon.json.

  2. Modifiez l’emplacement d’installation par défaut de l’image Docker en définissant l’emplacement data-root de votre choix sur votre machine locale.

     {
"data-root": "d:\\\\docker"
}

  3. Enregistrez le fichier daemon.json.

  4. Redémarrez Docker en exécutant la commande suivante :

    net stop docker
net start docker

Vous êtes maintenant prêt à installer ArcGIS Notebook Server sur votre machine.

Configurer un répertoire temporaire autre que celui par défaut pour Docker

Docker Engine 29.4 et versions ultérieures prennent en charge la configuration d’un répertoire temporaire autre que celui par défaut en utilisant la variable environnement DOCKER_TMPDIR. Cette variable d’environnement permet à Docker d’utiliser un répertoire autre que l’emplacement temporaire par défaut C :\ pour le stockage temporaire (pendant la post-installation lors du chargement de l’image d’exécution du Notebook, par exemple). Pour configurer un répertoire temporaire autre que celui par défaut pour Docker, procédez comme suit :

  1. Créez un répertoire temporaire sur un lecteur autre que celui par défaut.

    Exemple :

    d:\docker-temp

  2. Sous Windows, cliquez sur System properties (Propriétés système) > Advanced (Avancées) > Environment variables (Variables d’environnement) > System variables (Variables système).

  3. Définissez une variable d’environnement à l’échelle du système avec les informations suivantes :

    Nom de la variable : DOCKER_TMPDIR

    Valeur de variable : <new temporary directory created in step 1>

  4. Redémarrez le service Docker :

    net stop docker
net start docker