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 en dos ediciones. Docker Desktop y Mirantis Container Runtime (anteriormente Docker Engine-Enterprise).
| Sistema operativo | Edición de Docker | Tipo 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.4.4 o posteriores | Linux | Hyper-V necesario |
Windows Server 2022 Standard y Datacenter | Mirantis Container Runtime versión 20.10 o posteriores | Windows versión beta | Hyper-V es opcional. Existen limitaciones en cuanto al número máximo de contenedores que se pueden ejecutar con aislamiento de Hyper-V en Windows Server 2022 Standard. Consulte las preguntas frecuentes de Windows para obtener más información. |
En ArcGIS Notebook Server 11.0, Docker Desktop es la edición adecuada par utilizar con Windows. Este software permite ejecutar ArcGIS Notebook Server.
Nota:
En la versión ArcGIS Notebook Server 11.0, ArcGIS Notebook Server admite Mirantis Container Runtime para Windows Server como versión beta. Para esta versión, se recomienda utilizar ArcGIS Notebook Server con Mirantis Container Runtime solo con fines de evaluación.
Para obtener más información sobre el uso de Mirantis Container Runtime con ArcGIS Notebook Server en 11.0, consulte Docker y ArcGIS Notebook Server.
Nota:
Docker y Mirantis Container Runtime son componentes de software de terceros, y es posible que este tema no proporcione el proceso completo para instalarlos. Consulte los sitios de Docker y Mirantis Container Runtime para obtener más información sobre su proceso de instalación.
Instalar Docker Desktop
Siga estos pasos para instalar Docker Desktop:
- 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:
- Si su sistema operativo es Windows Server 2022 o Windows Server 2019, consulte Instalar el rol de Hyper-V en Windows Server.
- Si su sistema operativo es Windows 10, consulte Instalar Hyper-V en Windows 10.
ArcGIS Notebook Server requiere Docker Desktop para Windows (versión 4.4.4 o posteriores).
- En un navegador, vaya a la página de descarga de Docker Desktop (Windows) en la tienda de Docker Hub.
- Inicie sesión en su cuenta de Docker Hub o regístrese para crear una cuenta.
- Descargue el software de Docker Desktop.
- Haga doble clic en el instalador de Docker para Windows para ejecutarlo.
- En el cuadro de diálogo Configuración del instalador, anule la selección de Utilizar WSL2 en lugar de Hyper-V.
- Cuando se haya completado, cierre el instalador.
- Haga clic en el botón Docker Desktop en el menú Inicio para iniciar Docker.
- 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
Configurar ajustes de Docker
Una vez que Docker esté instalado en su equipo, modifique los ajustes que se describen a continuación.
Modificar los ajustes 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.
- 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 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.
- Anule la selección de la opción Utilizar el motor basado en WSL2 si está seleccionada.
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.
- 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 > Uso compartido de archivos.
- 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.
Limitar los 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.
- 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.
- Si lo desea, cambie la configuración siguiente:
- 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. - Cuando esté conforme con los límites de recursos establecidos, haga clic en Aplicar.
Instalar Mirantis Container Runtime en Windows
Precaución:
Mirantis Container Runtime en Windows se admite como versión beta para ArcGIS Notebook Server en Windows Server 2022. Mientras estén en fase beta, estas funciones pueden tener problemas conocidos de rendimiento o calidad y no contarán con la asistencia técnica de Esri. No habilite Hyper-V, porque no es necesario para la instalación de Mirantis Container Runtime en Windows Server 2022. No habilite la función Contenedores en su servidor local antes de instalar Mirantis Container Runtime.- Desinstale cualquier versión anterior de Docker de su equipo.
- Siga los pasos que se indican en la documentación Instalar MCR en Windows Server facilitada por Mirantis.
- Ejecute el siguiente comando para verificar que Mirantis Container Runtime está bien instalado y se ha iniciado:
docker run hello-world:nanoserver - Una vez completado, siga estos pasos para configurar Mirantis Container Runtime.
Configurar Mirantis Container Runtime
Siga estos pasos para configurar Mirantis Container Runtime en su equipo.
- Habilite el puerto 2375 para poder utilizar la API remota de Docker.
Este puerto solo lo utilizará ArcGIS Notebook Server internamente y se debe proteger del uso externo.
Abra una ventana de comandos como administrador y ejecute el siguiente comando:
sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://0.0.0.0:2375 -H npipe://" - Abra una ventana de PowerShell como administrador y ejecute el siguiente comando:
Restart-Service docker
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.