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.
Descargar e instalar Docker
La edición de Docker que se necesita para ejecutar ArcGIS Notebook Server en Windows es Docker Desktop Community. Está disponible mediante la aplicación Docker Desktop para Windows. Siga estos pasos para instalar Docker en su equipo.
- 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 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 for Windows (versión 3.0.0 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, no permita que Docker utilice contenedores de Windows, puesto que ArcGIS Notebook Server requiere contenedores de Linux.
- 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.
Utilizar el puerto 2375
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.
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 este paso.
- 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.
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.