Motores de contenedores y ArcGIS Notebook Server
ArcGIS Notebook Server utiliza un software de asignación de contenedores Docker.
Software Docker
ArcGIS Notebook Server utiliza el software de asignación de contenedores Docker para garantizar la seguridad y aislar los recursos de 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 individual 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 independiente de terceros que se debe instalar en cada equipo con ArcGIS Notebook Server antes de utilizar ArcGIS Notebook Server.
Imágenes de contenedores Docker
Cuando reciba las descargas de software y los archivos de autorización de My Esri antes de la instalación, también recibirá dos imágenes de contenedor de Docker específicas para 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 las 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
Docker está disponible en dos ediciones. Docker y Mirantis Container Runtime (anteriormente Docker Engine-Enterprise). Ambas ediciones cuentan con todas las características.
Nota:
Consulte las Preguntas frecuentes sobre Docker para obtener más información sobre la versión y el precio de Docker.
Asegúrese de instalar Docker o Mirantis Container Runtime en cada equipo con 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.
Tiempos 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.
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
ArcGIS Notebook Server es compatible con contenedores de Windows que utilicen Mirantis Container Runtime o Docker Engine a partir de binarios como opciones de motor de contenedor en Windows.
Motores de contenedor para Windows
Similar a otras implementaciones de ArcGIS Notebook Server, ArcGIS Notebook Server con contenedores Windows se instala en un sistema operativo de servidor y se configura y federa con un portal de ArcGIS Enterprise. Además, se puede implementar un Web Adaptor delante del software de ArcGIS Notebook Server.
ArcGIS Notebook Server utiliza sistemas operativos virtualizados conocidos como contenedores para aislar los entornos de los autores de notebooks. Como resultado, los contenedores permiten que cada autor utilice un subconjunto de los recursos del servidor sin que su trabajo o uso de recursos interfieran con otros.
Estos contenedores los asigna y mantiene un motor de contenedor externo, ya sea Mirantis Container Runtime o Docker Engine a partir de binarios. Antes de instalar ArcGIS Notebook Server, debe instalar un motor de contenedor. Una vez que se ha instalado ArcGIS Notebook Server, se debe configurar para que funcione con dicho motor de contenedor.
ArcGIS Notebook Server asigna un contenedor por tiempo de ejecución al autor de cada notebook del sitio, y solo ellos pueden trabajar en el contenedor. Los recursos informáticos que utilizan los autores al ejecutar notebooks no influirá en los contenedores de otros autores.
Cuando un miembro del portal con los privilegios correspondientes abre su primer notebook, se inicia un contenedor en el sitio de ArcGIS Notebook Server. Esta sesión entre el notebook y el contenedor se mantendrá vigente todo el tiempo de duración del notebook.
ArcGIS Notebook Server puede unir varios equipos en un mismo sitio. Los equipos de una configuración de varios equipos se deben configurar para que sean idénticos, y cada equipo debe poder ejecutar ArcGIS Notebooks.
Tiempos de ejecución de notebook e imágenes de contenedor de Windows
Se proporciona una única imagen de contenedor de Windows para ArcGIS Notebook Server. Esta imagen de contenedor incluye los tiempos de ejecución de notebook Standard y Advanced, con los que los recursos de Python están disponibles en ArcGIS Notebooks. Consulte Bibliotecas de Python disponibles para obtener más información sobre las bibliotecas disponibles en cada tiempo de ejecución.
Los dos tiempos de ejecución de ArcGIS Notebook Server, Standard y Advanced, están disponibles en notebooks como parte de la imagen del contenedor. En función de su licencia y privilegios de usuario, estarán disponibles para su uso los tiempos de ejecución Standard o Standard y Advanced.
Los contenedores de Windows en un sitio de ArcGIS Notebook Server admiten dos modos de aislamiento de tiempo de ejecución, proceso e Hyper-V. Consulte la documentación de Microsoft sobre Modos de aislamiento para obtener más información sobre los modos. Si configura su sitio para usar el aislamiento Hyper-V, el rol Hyper-V debe estar instalado en el equipo. Consulte la documentación de Microsoft para obtener más información sobre cómo instalar Hyper-V para Windows Server.
Nota:
Existen limitaciones en cuanto al número de contenedores que se pueden ejecutar al utilizar contenedores de Windows con Hyper-V. Consulte Preguntas frecuentes de Microsoft sobre contenedores para obtener más información.
Cuando se inicia un contenedor, se le aplica la imagen del contenedor de Windows proporcionada por Esri. El tiempo de ejecución dependerá de la licencia configurada para ArcGIS Notebook Server y de los privilegios del autor del notebook.
Nota:
Existe una limitación conocida que puede dar lugar a un WinError 1455 al importar la biblioteca de torch o las bibliotecas de Python que tienen torch como dependencia. Consulte Problemas y soluciones comunes para obtener más información.
Requisitos previos y restricciones para los sistemas de Windows
Si implementa ArcGIS Notebook Server en equipos Windows con contenedores Windows, hay requisitos previos y restricciones que debe tener en cuenta.
Requisitos previos de Mirantis Container Runtime
Tenga en cuenta lo siguiente al trabajar con Mirantis Container Runtime:
Actualmente, Mirantis Container Runtime solo es compatible con Windows Server 2022.
Cuando ArcGIS Notebook Server y Mirantis Container Runtime se implementan en varios equipos, ya no es necesario configurar la replicación (DFS) para el directorio de su espacio de trabajo. El directorio del espacio de trabajo se puede compartir como una ruta montada en una unidad con Mirantis Container Runtime.