ArcGIS Notebook Server utiliza el software de asignación de contenedores de Docker.
Software de Docker
ArcGIS Notebook Server utiliza el software de asignación de contenedores de Docker para proporcionar seguridad y aislar recursos para los autores de notebooks. Los contenedores son sistemas operativos virtualizados, en lugar de máquinas virtuales; cada contenedor de un equipo incluye todos los componentes de SO en un entorno independiente. ArcGIS Notebook Server proporciona un contenedor diferente para cada usuario del sitio. Cada usuario posee un contenedor por tiempo de ejecución y los usuarios solo pueden ejecutar notebooks en su propio contenedor.
Docker es un componente de software de terceros independiente que se debe instalar en cada equipo de ArcGIS Notebook Server antes de utilizar ArcGIS Notebook Server.
Imágenes de contenedor de Docker
Cuando se reciben las descargas de software y los archivos de autorización de My Esri antes de la instalación, también se reciben dos imágenes de contenedor de Docker específicas de ArcGIS Notebooks. Estas imágenes de contenedor proporcionan el tiempo de ejecución necesario para los usuarios de notebook, es decir, un conjunto específico de módulos de Python.
Esri proporciona dos imágenes de contenedor de Docker: Standard y Advanced. Estas dos imágenes de contenedor incluyen herramientas del sistema y bibliotecas, así como varios ajustes para configurar el contenedor correctamente. También incluyen un tiempo de ejecución de notebook: la imagen de contenedor Standard incluye el tiempo de ejecución de notebook Standard, y la imagen de contenedor Advanced incluye el tiempo de ejecución Advanced.
El tiempo de ejecución de Standard permite a ArcGIS Notebooks utilizar códigos de ArcGIS API for Python y módulos de terceros. El tiempo de ejecución Advanced contiene todos los módulos de la imagen Standard e incluye también ArcPy y bibliotecas relacionadas.
Si tiene una licencia Advanced, debe descargar e instalar ambas imágenes de contenedor desde My Esri. Los módulos de Python contenidos en las imágenes Standard y Advanced se enumeran en Ver bibliotecas de Python disponibles.
Para crear notebooks con el tiempo de ejecución Advanced, el usuario debe tener asignado un rol en el portal que incluya el privilegio Notebooks avanzados. La primera vez que abran un notebook, se iniciará un contenedor para ellos, con la imagen de contenedor Advanced aplicada.
Los autores de notebooks con el privilegio Notebooks avanzados también pueden especificar un notebook para utilizar el tiempo de ejecución Standard. Esto les permite compartir notebooks que han creado con usuarios que solo tienen acceso al tiempo de ejecución Standard. La primera vez que lo hagan, se iniciará un segundo contenedor para ellos, cargado con la imagen de contenedor Standard.
Más información sobre los privilegios de usuario de notebook
De forma predeterminada, a un contenedor se le asigna una cantidad de RAM concreta y un número concreto de recursos compartidos de la CPU. Estos límites predeterminados de los recursos los determina por tiempo de ejecución que ejecuta el contenedor de la siguiente manera:
- El tiempo de ejecución Standard asigna 1 núcleo de CPU y 4 GB de RAM por contenedor.
- El tiempo de ejecución Advanced asigna 2 núcleos de CPU y 6 GB de RAM por contenedor.
Como administrador de ArcGIS Notebook Server, supervise la cantidad de autores de notebook que trabajan en su sitio y qué tiempo de ejecución utiliza cada uno de ellos. En función de estos factores, es posible que necesite o desee cambiar los límites de recursos establecidos para ArcGIS Notebook Server.
Ediciones de Docker
Para los usuarios de Windows, Docker Desktop es la edición adecuada. Este software le permite ejecutar ArcGIS Notebook Server.
Asegúrese de instalar Docker Desktop 4.4.4 o posteriores en cada equipo de ArcGIS Notebook Server. Para obtener más información sobre la instalación y configuración de Docker, consulte Instalar Docker para ArcGIS Notebook Server.
Nota:
ArcGIS Notebook Server solo funcionará con una de las ediciones de Docker instalada en un equipo. No puede mezclar ediciones en un sitio de varios equipos.
Tiempo de ejecución de notebook e imágenes de contenedor
Cuando se inicia un contenedor por primera vez, a menudo está vacío. Las bibliotecas del sistema, herramientas y configuraciones que necesita el contenedor para funcionar se proporcionan a través de un archivo de imagen de contenedor. La imagen de contenedor se aplica al contenedor como parte del proceso de inicio.
Sugerencia:
Si ha implementado software en la nube, probablemente esté familiarizado con las imágenes de equipo, que proporcionan equipos virtuales vacíos con el código, las herramientas y la configuración necesarios para su funcionamiento. Las imágenes de contenedor funcionan igual que el sistema operativo virtual vacío del contenedor.
Esri proporciona dos imágenes de contenedor a ArcGIS Notebook Server. En cada imagen de contenedor se incluye un tiempo de ejecución del notebook, que hace que los recursos de Python estén disponibles en ArcGIS Notebooks. Cada tiempo de ejecución empaqueta una lista de estas bibliotecas y dependencias, incluida una versión específica de cada biblioteca de Python.
Los dos tiempos de ejecución de ArcGIS Notebook Server, Standard (que incluye ArcGIS API for Python y otros módulos de Python) y Advanced (que también incluye ArcPy), están disponibles en los notebooks como parte de su imagen de contenedor correspondiente.
Ver las bibliotecas disponibles de cada tiempo de ejecución
En función de su licencia, solo recibirá la imagen de contenedor Standard o las imágenes de contenedor Standard y Advanced.
En equipos Windows, los contenedores de un sitio de ArcGIS Notebook Server que tiene contenedores de Linux se administran en un emulador de Linux denominado MobyLinuxVM, que está incluido en el entorno Hyper-V. En consecuencia, el rol Hyper-V debe estar instalado en el equipo. Este requisito está incluido en los Requisitos del sistema de ArcGIS Notebook Server.
Cuando se inicia un contenedor, se le aplica una de las dos imágenes de contenedor que recibió de Esri. El tiempo de ejecución y la imagen aplicados dependen de los privilegios del autor del notebook en el portal:
- Los autores a los que solo se les concede el privilegio Crear y editar notebooks tendrán su contenedor cargado con la imagen del contenedor Standard. Todos los notebooks que abran utilizarán el tiempo de ejecución Standard.
- Los autores a los que también se les haya concedido el privilegio Notebooks avanzados tendrán su contenedor cargado con la imagen del contenedor de Advanced. El tiempo de ejecución predeterminado del notebook para sus notebooks es el tiempo de ejecución Advanced. Sin embargo, pueden especificar el tiempo de ejecución de un notebook individual y utilizar el tiempo de ejecución Standard o Advanced en sus notebooks.
Más información sobre los privilegios de usuario de notebook
Requisitos previos y restricciones para los sistemas de Windows
Si implementa ArcGIS Notebook Server en equipos de Windows, existen varios requisitos previos y restricciones que debe tener en cuenta. No se aplican al implementar ArcGIS Notebook Server en equipos Linux.
Requisitos previos de Docker Desktop
Se requiere lo siguiente para utilizar Docker Desktop:
- Se recomienda utilizar equipos con Windows Server 2019 en un entorno de producción de ArcGIS Notebook Server. Los equipos de Windows 10 solo son compatibles con entornos de desarrollo.
- Si implementa ArcGIS Notebook Server en Windows Server 2019, puede utilizar Docker Desktop (versión 4.4.4 o posterior). Tenga en cuenta que la documentación de Docker de la versión actual no menciona Windows Server 2019 en sus requisitos del sistema.
- ArcGIS Notebook Server 10.8.x ya no es compatible con Windows Server 2016.
- ArcGIS Notebook Server utiliza contenedores de Linux en su componente de Docker. En equipos Windows, los contenedores de un sitio de ArcGIS Notebook Server se administran en un emulador de Linux denominado MobyLinuxVM, que está incluido en el entorno Hyper-V.
- ArcGIS Notebook Server requiere que el rol Hyper-V ya esté instalado en Windows Server y Windows 10.
- Ciertos entornos de virtualización no permiten que Hyper-V se habilite y utilice en Windows. Como resultado, ArcGIS Notebook Server no puede instalarse ni manejarse en este tipo de entornos.
- El servicio Docker Desktop dejará de funcionar cuando el usuario que esté instalando Docker cierre la sesión del equipo ArcGIS Notebook Server donde Docker está instalado. Este equipo ArcGIS Notebook Server se puede bloquear, pero el usuario debe iniciar sesión para que Docker funcione correctamente. Si el usuario no ha iniciado sesión, se producirá un error al abrir notebooks con el siguiente mensaje Error al cargar el notebook.
Nota:
Hay soluciones alternativas para conseguir que Docker Desktop se ejecute automáticamente después de reiniciar el equipo ArcGIS Notebook Server, en lugar de que el usuario tenga que iniciar sesión.
- A partir de la versión 10.7.1, ArcGIS Notebook Server admite sitios de varios equipos. En sistemas Windows, Docker no admite el montaje de unidades compartidas en contenedores, por lo que el directorio de espacio de trabajo debe estar ubicado en local en cada equipo. Dado que los usuarios pueden iniciar contenedores y abrir notebooks en cada equipo en un sitio de varios equipos, es necesario que el contenido del directorio de espacio de trabajo esté sincronizado en todos los equipos. Los pasos para configurar un método de replicación se describen en Configurar la replicación DFS para ArcGIS Notebook Server.