Skip to main content

Instalar un motor de contenedor para ArcGIS Notebook Server

En los pasos siguientes se describe cómo descargar, instalar y configurar el software de asignación de contenedores que requiere ArcGIS Notebook Server. Consulte Motores de contenedores y ArcGIS Notebook Server para obtener una introducción a los motores de contenedor y a la forma de usarlos en ArcGIS Notebook Server.

Descargar e instalar un motor de contenedor

Hay dos motores de contenedores disponibles para sistemas Linux: Docker Engine y Mirantis Container Runtime.

Si utiliza Ubuntu o Red Hat Enterprise Linux Server, puede utilizar cualquiera de las dos ediciones de Docker.

Motor de contenedores

Sistema operativo

Docker Engine Community edición 29.2.0 o posterior

Nota:

Si está utilizando la versión 29 de Docker Engine o versiones posteriores y se ha actualizado desde una versión anterior, edite /etc/docker/daemon.json para habilitar el almacén de imágenes de containerd. Consulte el paso 4 de Configurar ajustes y entornos de Docker para obtener más información.

Ubuntu Server LTS 24.04.3

Ubuntu Server LTS 22.04.5

Red Hat Enterprise Linux Server 8 actualización 10

Red Hat Enterprise Linux Server 9 actualización 7

Rocky Linux 8 actualización 10

Rocky Linux 9 actualización 7

AlmaLinux 8 actualización 10

AlmaLinux 9 actualización 7

Mirantis Container Runtime versión 25.0.15 o posterior

Nota:

Consulte la matriz de compatibilidad de Mirantis Container Runtime 25.0 para obtener la información más actualizada.

Ubuntu Server LTS 22.04.3

Ubuntu Server LTS 24.04.2

Red Hat Enterprise Linux Server 8 actualización 10

Red Hat Enterprise Linux Server 9 actualización 7

Oracle Linux 9 actualización 7

Rocky Linux 8 actualización 10

Rocky Linux 9 actualización 7

SUSE Linux Enterprise Server (SLES) 15 SP6

Mirantis Container Runtime

ArcGIS Notebook Server en Windows con Mirantis Container Runtime es compatible con los siguientes sistemas operativos:

Sistema operativo

Motor de contenedores

Requisitos adicionales

Windows Server 2022 Standard y Datacenter

Mirantis Container Runtime versión 25.0.15 o posterior

También puede instalar Hyper-V.

Nota:

Existen limitaciones en cuanto al número máximo de contenedores que se pueden ejecutar con aislamiento de Hyper-V en Windows Server Standard.

Consulte las preguntas frecuentes de Windows para obtener más información.

Docker Engine a partir de binarios

ArcGIS Notebook Server en Windows con Docker Engine a partir de binarios es compatible con los siguientes sistemas operativos y versiones de Docker Engine:

Sistema operativo

Motor de contenedores

Requisitos adicionales

Windows Server 2025 Standard y Datacenter

Windows Server 2022 Standard y Datacenter

Docker Engine - Community versión 29.2.0 o posterior

También puede instalar Hyper-V.

Nota:

Existen limitaciones en cuanto al número máximo de contenedores que se pueden ejecutar con aislamiento de Hyper-V en Windows Server Standard.

Consulte las preguntas frecuentes de Windows para obtener más información.
Nota:

Puesto que Docker es un componente de software de terceros, este tema no detalla los pasos completos para instalar Docker. Consulte el sitio web de Docker para obtener la información más actualizada.

Instalar Mirantis Container Runtime en Red Hat Enterprise Linux Server, Ubuntu, SUSE Linux Enterprise Server y Oracle Linux

Para instalar Mirantis Container Runtime, debe adquirir una versión de prueba o una suscripción del software.

  1. Desinstale cualquier versión anterior de Docker de su equipo.

    Consulte la documentación de Docker correspondiente a esa versión para conocer los pasos completos para desinstalarla.

  2. Siga los pasos de la guía de instalación Mirantis Container Runtime de su distribución de Linux.

    Nota:

    Actualmente, Mirantis no tiene una guía de instalación separada para Rocky Linux, pero la guía de instalación de Red Hat Enterprise Linux se puede seguir para la instalación en Rocky Linux.

    Nota:

    En este documento, se describen los dos métodos que se pueden utilizar para instalar el software (desde un repositorio de Docker o a través de un paquete RPM).

  3. Dado que Docker no se inicia automáticamente una vez finalizadas su instalación y configuración, ejecute el siguiente comando para iniciar el daemon de Docker:

$ sudo systemctl start docker

  1. Ejecute el siguiente comando para comprobar que Docker se haya instalado correctamente y pueda acceder a imágenes de contenedor:

$ sudo docker run hello-world

Continúe con la sección Configurar ajustes y entornos de Docker que aparece a continuación.

Instalar Docker Engine en Red Hat Enterprise Linux Server, Oracle Linux, Rocky Linux o AlmaLinux

La edición Docker Engine se puede descargar de forma gratuita, pero es necesario disponer de una cuenta de Docker.

  1. Desinstale cualquier versión anterior de Docker de su equipo.

    Consulte la documentación de Docker correspondiente a esa versión para conocer los pasos completos para desinstalarla.

  2. Siga los pasos de Instalar Docker Engine en RHEL.

    En este documento, se describen los dos métodos que se pueden utilizar para instalar el software (desde un repositorio de rpm o a través de un paquete rpm).

    El daemon de Docker se inicia automáticamente después de la instalación.

  3. Ejecute el siguiente comando para comprobar que Docker se haya instalado correctamente y pueda acceder a imágenes de contenedor:

$ sudo docker run hello-world

Continúe con la sección Configurar ajustes y entornos de Docker que aparece a continuación.

Instalar Docker Engine en Ubuntu

La edición Docker Engine se puede descargar de forma gratuita, pero es necesario disponer de una cuenta de Docker.

  1. Desinstale cualquier versión anterior de Docker de su equipo.

    Consulte la documentación de Docker correspondiente a esa versión para conocer los pasos completos para desinstalarla.

  2. Siga los pasos de Instalar Docker Engine en Ubuntu.

    En este documento, se describen los dos métodos que se pueden utilizar para instalar el software (desde un repositorio de Docker o a través de un paquete DEB).

    El daemon de Docker se inicia automáticamente después de la instalación.

  3. Ejecute el siguiente comando para comprobar que Docker se haya instalado correctamente y pueda acceder a imágenes de contenedor:

$ sudo docker run hello-world

Continúe con la sección Configurar ajustes y entornos de Docker que aparece a continuación.

Configurar ajustes y entornos de Docker

Una vez instalada la edición apropiada de Docker en su equipo, configure Docker para utilizarlo con ArcGIS Notebook Server.

  1. Agregue su cuenta de usuario del SO (o la cuenta utilizada para instalar ArcGIS Notebook Server) al grupo llamado docker, que se ha creado automáticamente durante la instalación.

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

  1. Cierre la sesión y vuelva a iniciarla con la cuenta de usuario del SO para que los cambios surtan efecto.

  2. Compruebe que pueda ejecutar los comandos de Docker desde la cuenta.

$ docker run hello-world

  1. Si está utilizando la versión 29 de Docker Engine o versiones posteriores y se ha actualizado desde una versión anterior, edite /etc/docker/daemon.json para habilitar el almacén de imágenes de containerd.

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

    Si daemon.json no existe, créelo.

  2. Asegúrese de que el directorio /var tenga al menos 75 GB de espacio en disco.

    Docker utiliza el directorio /var como su registro local para imágenes de contenedor. Durante el proceso de actualización de versiones posteriores, también se copiarán imágenes nuevas en el directorio /var. Si no hay espacio suficiente, aumente la asignación del directorio /var o siga los subpasos que se indican a continuación para cambiar la ubicación del directorio raíz de Docker.

    1. Edite /etc/docker/daemon.json para establecer data-root en un directorio local de su equipo que disponga de espacio suficiente.

      Nota:

      Si no existe este archivo, créelo.

      Ruta de ejemplo:

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

      A continuación, se muestra un ejemplo de /etc/docker/daemon.json con las propiedades containerd-snapshotter y data-root:

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

    2. Elimine /var/lib/docker y cree un vínculo simbólico que haga referencia a la ruta especificada en el paso anterior.

       $ sudo mkdir /data/docker
   $ sudo rm -rf /var/lib/docker
   $ sudo ln -s /data/docker /var/lib/docker
    1. Este paso solo es necesario si se utiliza la versión 29 del motor de contenedores Docker. Elimine /var/lib/containerd y cree un vínculo simbólico que haga referencia a la ruta especificada en el paso anterior.
       $ sudo mkdir /data/containerd
   $ sudo rm -rf /var/lib/containerd
   $ sudo ln -s /data/containerd /var/lib/containerd

  3. Reinicie el servicio Docker para aplicar los cambios.

    $ 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

Ahora ya está todo listo para instalar ArcGIS Notebook Server en su equipo.

Requisitos del motor de contenedor

ArcGIS Notebook Server en Windows es compatible con Mirantis Container Runtime y Docker Engine a partir de binarios como motores de contenedores. Consulta Motores de contenedores y ArcGIS Notebook Server para una introducción a los motores de contenedores y cómo se integran en ArcGIS Notebook Server.

Hay dos motores de contenedores disponibles para sistemas Linux: Docker Engine y Mirantis Container Runtime.

Si utiliza Ubuntu o Red Hat Enterprise Linux Server, puede utilizar cualquiera de las dos ediciones de Docker.

Motor de contenedores

Sistema operativo

Docker Engine Community edición 29.2.0 o posterior

Nota:

Si está utilizando la versión 29 de Docker Engine o versiones posteriores y se ha actualizado desde una versión anterior, edite /etc/docker/daemon.json para habilitar el almacén de imágenes de containerd. Consulte el paso 4 de Configurar ajustes y entornos de Docker para obtener más información.

Ubuntu Server LTS 24.04.3

Ubuntu Server LTS 22.04.5

Red Hat Enterprise Linux Server 8 actualización 10

Red Hat Enterprise Linux Server 9 actualización 7

Rocky Linux 8 actualización 10

Rocky Linux 9 actualización 7

AlmaLinux 8 actualización 10

AlmaLinux 9 actualización 7

Mirantis Container Runtime versión 25.0.15 o posterior

Nota:

Consulte la matriz de compatibilidad de Mirantis Container Runtime 25.0 para obtener la información más actualizada.

Ubuntu Server LTS 22.04.3

Ubuntu Server LTS 24.04.2

Red Hat Enterprise Linux Server 8 actualización 10

Red Hat Enterprise Linux Server 9 actualización 7

Oracle Linux 9 actualización 7

Rocky Linux 8 actualización 10

Rocky Linux 9 actualización 7

SUSE Linux Enterprise Server (SLES) 15 SP6

Mirantis Container Runtime

ArcGIS Notebook Server en Windows con Mirantis Container Runtime es compatible con los siguientes sistemas operativos:

Sistema operativo

Motor de contenedores

Requisitos adicionales

Windows Server 2022 Standard y Datacenter

Mirantis Container Runtime versión 25.0.15 o posterior

También puede instalar Hyper-V.

Nota:

Existen limitaciones en cuanto al número máximo de contenedores que se pueden ejecutar con aislamiento de Hyper-V en Windows Server Standard.

Consulte las preguntas frecuentes de Windows para obtener más información.

Docker Engine a partir de binarios

ArcGIS Notebook Server en Windows con Docker Engine a partir de binarios es compatible con los siguientes sistemas operativos y versiones de Docker Engine:

Sistema operativo

Motor de contenedores

Requisitos adicionales

Windows Server 2025 Standard y Datacenter

Windows Server 2022 Standard y Datacenter

Docker Engine - Community versión 29.2.0 o posterior

También puede instalar Hyper-V.

Nota:

Existen limitaciones en cuanto al número máximo de contenedores que se pueden ejecutar con aislamiento de Hyper-V en Windows Server Standard.

Consulte las preguntas frecuentes de Windows para obtener más información.

Instalar Mirantis Container Runtime

Siga estos pasos para instalar Mirantis Container Runtime:

  1. Desinstale cualquier versión anterior de Docker de su equipo.

  2. No habilite la entidad Contenedores en su servidor local antes de instalar Mirantis Container Runtime. Si ya está habilitada, desactívela en su equipo de servidor. Consulte Instalar o desinstalar roles, servicios de roles o entidades en la documentación de Microsoft para obtener más información.

  3. Siga los pasos descritos en Instalar Mirantis Container Runtime en Windows Server de la documentación de Mirantis para obtener y ejecutar el script de instalación install.ps1 de Mirantis Container Runtime para Windows Server.

    Para ejecutar el script de instalación, utilice el siguiente código:

    ./install.ps1

  4. Compruebe que Mirantis Container Runtime esté instalado y se haya iniciado ejecutando el siguiente comando:

docker run hello-world:nanoserver

  1. Una vez completado, siga los pasos de Configurar su componente Docker para configurar Mirantis Container Runtime.

Instalar Docker Engine a partir de binarios

Siga estos pasos para instalar Docker Engine a partir de binarios:

  1. Desinstale cualquier versión anterior de Docker de su equipo.

  2. Deshabilite la función Contenedores en su servidor local si está habilitado.

    Consulte la documentación de Microsoft para obtener más información.

  3. Habilite la función Contenedores de Windows mediante la ejecución del comando siguiente en Microsoft Powershell con privilegios administrativos:

Add-WindowsFeature Containers

  1. Siga las indicaciones para reiniciar el equipo.

  2. Verifique la instalación de la función Contenedores ejecutando el comando siguiente:

Get-WindowsFeature Containers

  1. Siga las instrucciones de la sección Instalar el servidor y los archivos binarios cliente en Windows en la documentación de Docker.

    Nota:

    Docker Engine a partir de binarios no se actualiza automáticamente. Debe actualizar manualmente a versiones más recientes de Docker. Consulte la documentación Instalar Docker a partir de binarios para obtener más información sobre las limitaciones de uso de Docker a partir de binarios en un entorno de producción. Aunque en esta página se recomienda utilizar Docker Desktop, ArcGIS Notebook Server con contenedores Windows no admite Docker Desktop en Windows como motor de contenedor.

  2. Agregue la ruta del directorio de Docker, por ejemplo, C:\Program Files\docker, a la variable de entorno Ruta de las variables del sistema.

  3. Verifique la instalación y el estado de ejecución del demonio de Docker mediante la ejecución del comando siguiente:

docker version

  1. Una vez completado, siga los pasos de Configurar su componente Docker para configurar Docker Engine.

Configurar su componente Docker

Siga estos pasos para configurar su componente Docker:

  1. Si la cuenta utilizada para instalar ArcGIS Notebook Server no forma parte del grupo del administrador, realice los pasos siguientes:

    1. En el menú Inicio del equipo con Windows, abra la aplicación Administración de equipos.

    2. En la barra lateral izquierda, expanda el elemento Usuarios y grupos locales y abra la carpeta Grupos.

    3. Seleccione el grupo docker-users de la lista de grupos y haga doble clic en él.

      Si todavía no existe un grupo de usuarios de Docker, cree uno.

    4. Haga clic en el botón Agregar, localice la cuenta que ha utilizado para instalar ArcGIS Notebook Server y elíjala. Haga clic en Aceptar para confirmarlo.

    5. Haga clic en Aceptar para cerrar el cuadro de diálogo del grupo.

    6. Cree un archivo de configuración en C:\ProgramData\docker\config\daemon.json para establecer un grupo de seguridad para Docker.

    7. Edite C:\ProgramData\docker\config\daemon.json para agregar el grupo docker-users.

       {
     "group" : "docker-users"
   }

  2. Configure su servicio Docker para que escuche en una canalización con nombre con el siguiente comando:

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

  1. Reinicie Docker con el siguiente comando:

    net stop docker
net start docker

  2. Una vez que el componente Docker se haya instalado, reinicie el equipo.

    Nota:

    Cada vez que instale o actualice el componente Docker, debe reiniciar la máquina.

Cambiar la ubicación de instalación de la imagen de Docker predeterminada

Opcionalmente, para cambiar la ubicación de instalación de la imagen de Docker predeterminada, realice estos pasos:

  1. Edite el archivo en C:\ProgramData\docker\config\daemon.json.

  2. Cambie la ubicación de instalación de imágenes de Docker predeterminada configurando la ubicación de data-root en la ubicación elegida en el equipo local.

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

  3. Guarde daemon.json.

  4. Reinicie Docker mediante la ejecución del siguiente comando:

    net stop docker
net start docker

Ahora ya está todo listo para instalar ArcGIS Notebook Server en su equipo.

Configurar un directorio temporal no predeterminado para Docker

Docker Engine 29.4 y posteriores permiten configurar un directorio temporal no predeterminado usando la variable de entorno DOCKER_TMPDIR. Esta variable de entorno habilita a Docker para que use un directorio distinto de la ubicación predeterminada C:\ temp para el almacenamiento temporal, por ejemplo, durante la posinstalación al cargar la imagen de tiempo de ejecución de Notebook. Siga estos pasos para configurar un directorio temporal no predeterminado para Docker:

  1. Cree un directorio temporal en una unidad que no sea la predeterminada.

    Ejemplo:

    d:\docker-temp

  2. En Windows, haga clic en Propiedades del sistema > Avanzadas > Variables de entorno > Variables del sistema.

  3. Establezca una variable de entorno a nivel de sistema con la siguiente información:

    Nombre de variable: DOCKER_TMPDIR

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

  4. Reiniciar el servicio de Docker:

    net stop docker
net start docker