Skip To Content

Instalar el motor de contenedor para ArcGIS Notebook Server (contenedores de Linux)

En los pasos siguientes se describe cómo descargar, instalar y configurar el software de asignación de contenedores de Docker requerido por ArcGIS Notebook Server. En Docker y ArcGIS Notebook Server, consulte la introducción sobre Docker y aprenda cómo se usa en ArcGIS Notebook Server.

Ediciones de Docker

Docker está disponible como Docker Desktop.

Sistema operativoEdición de DockerTipo de imagen de tiempo de ejecución de notebook (contenedor)Requisitos adicionales

Windows Server 2019 Standard y Datacenter

Windows Server 2022 Standard y Datacenter

Docker Desktop en Windows versión 4.19.0 o posterior

Linux

Hyper-V necesario

Nota:

Docker es un componente de software de terceros y es posible que este tema no proporcione todo el proceso para instalarlos. Consulte el sitio de Docker para obtener más información sobre sus procesos de instalación.

Instalar Docker Desktop

Siga estos pasos para instalar Docker Desktop:

  1. Compruebe que Hyper-V esté instalado en su equipo Windows. Para ello, busque la aplicación Hyper-V Manager. Si no está instalado, instálelo antes de continuar. Consulte la siguiente documentación de Microsoft para saber qué pasos debe seguir:

    ArcGIS Notebook Server requiere Docker Desktop para Windows (versión 4.19.0 o posterior).

  2. En un navegador, vaya a la página de descarga de Docker Desktop (Windows) en la tienda de Docker Hub.
  3. Inicie sesión en su cuenta de Docker Hub o regístrese para crear una cuenta.
  4. Descargue el software de Docker Desktop.
  5. Haga doble clic en el instalador de Docker para Windows para ejecutarlo.
  6. En el cuadro de diálogo Configuración del instalador, anule la selección de Utilizar WSL2 en lugar de Hyper-V.
  7. Cuando se haya completado, cierre el instalador.
  8. Haga clic en el botón Docker Desktop en el menú Inicio para iniciar Docker.
  9. Compruebe que Docker se haya iniciado. Para ello, utilice uno de los siguientes métodos:
    • Consulte el estado del icono Docker de la bandeja del sistema de Windows (normalmente se encuentra en la esquina inferior derecha de su pantalla).
    • Abra la ventana de comando y ejecute los comandos siguientes:
      docker version
      docker run hello-world
      El primer comando proporciona la versión de Docker de su equipo; el segundo comprueba que Docker pueda acceder a imágenes de contenedor y ejecutarlas.

Configurar ajustes de Docker

Una vez que Docker esté instalado en su equipo, modifique los ajustes que se describen a continuación.

Configuración de los parámetros generales

Utilizará la API remota de Docker, que requiere el uso del puerto 2375. Este puerto solo lo utilizará ArcGIS Notebook Server internamente y se debe proteger del uso externo.

  1. Haga clic con el botón derecho en el botón Docker de la bandeja del sistema de Windows y haga clic en Configuración.
  2. En la página General, consulte Exponer servicio en tcp://localhost:2375 sin TLS.

    Puede que reciba una advertencia de seguridad. Asegúrese de que el administrador del sistema sepa que este puerto se utiliza internamente y que no se debe permitir el acceso externo a él.

  3. Anule la selección de la opción Utilizar el motor basado en WSL2 si está seleccionada.

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

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

  1. Abra la configuración Docker Desktop.
  2. Haga clic en Recursos > Avanzados.
  3. Defina Disk image location en la ruta del directorio local elegido de su equipo.

Definir el uso compartido de archivos

El contenedor de Docker debe tener acceso a la unidad local que se configurará como directorio del espacio de trabajo o a un directorio de datos personalizados correspondiente a Notebook Server. Siga los pasos que se indican a continuación durante la instalación inicial y repítalos siempre que las credenciales de la cuenta Ejecutar como cambien o si cambia la propia cuenta Ejecutar como. Si crea una cuenta durante la instalación de ArcGIS Notebook Server, se le redirigirá a estos pasos.

  1. Haga clic con el botón derecho en el botón Docker de la bandeja del sistema de Windows y haga clic en Configuración.
  2. En el menú Ajustes, haga clic en Recursos > Uso compartido de archivos.
  3. Agregue la ruta de la unidad o el directorio correspondiente al espacio de trabajo de ArcGIS Notebook Server o al directorio de datos personalizados.
    Nota:

    Si un directorio de espacio de trabajo o un directorio de datos personalizado no existe actualmente, por ejemplo, C:\arcgisnotebookserver, cree un sitio de ArcGIS Notebook Server o registre un directorio de datos antes de realizar este paso.

    Nota:
    Docker para Windows solo admite directorios locales en Windows que se comparten con contenedores de Linux.

Configurar recursos avanzados

Puede utilizar el panel de configuración de Docker Desktop para limitar los recursos disponibles para ArcGIS Notebook Server y los contenedores que se ejecutan en el sitio de su servidor.

  1. Haga clic con el botón derecho en el botón Docker de la bandeja del sistema de Windows y haga clic en Configuración. En el menú Ajustes, haga clic en Recursos > Avanzados.
  2. Cambie los siguientes ajustes:
    • CPU: número de núcleos de CPU disponibles para los contenedores de su equipo. Esto se configura en dos núcleos de manera predeterminada. Puede actualizar este valor en función de los recursos disponibles en el equipo y los límites de CPU establecidos para los tiempos de ejecución del notebook.
    • Memoria: cantidad de memoria disponible para los contenedores de su equipo. Está configurada en 2 GB de manera predeterminada. Puede aumentarse hasta un mínimo de 6 GB. Es posible que quiera aumentar este valor en función de los recursos disponibles en el equipo y los límites de memoria establecidos para los tiempos de ejecución del notebook.
    • Intercambio: cantidad de espacio en disco que pueden usar los contenedores como memoria si se alcanza el límite anterior.
    • Tamaño de imagen de disco: tamaño de la imagen del disco. Revise y actualice este valor según sea necesario si la instalación de imágenes de contenedor de Docker para Notebooks da lugar a un error de espacio en disco insuficiente.
    • Ubicación de imagen de disco: directorio en el que se guardan los contenedores y las imágenes.

    Nota:
    Regrese a este paso siempre que realice actualizaciones en la CPU o los recursos de memoria configurados para los tiempos de ejecución del notebook.

  3. Cuando esté conforme con los límites de recursos establecidos, haga clic en Aplicar.

Una vez que el componente Docker se haya instalado, reinicie el equipo. Debe reiniciar el equipo cada vez que instale o actualice el componente Docker.

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