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 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.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:
- 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.19.0 o posterior).
- 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.
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.
- 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.
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:
- Abra la configuración Docker Desktop.
- Haga clic en Recursos > Avanzados.
- 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.
- 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.
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.
- 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.
- 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. - 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.