En la versión 11.0, ArcGIS Notebook Server con contenedores Windows y Mirantis Container Runtime está disponible como versión beta en Windows.
Nota:
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.
Contenedores ArcGIS Notebook Server y Windows
Al igual que en otras implementaciones de ArcGIS Notebook Server, ArcGIS Notebook Server con contenedores de 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 Mirantis Container Runtime, anteriormente llamado Docker Engine Enterprise, un componente de software externo. Antes de instalar ArcGIS Notebook Server, debe instalar la versión 20.10 o posterior de Mirantis Container Runtime. Una vez instalado ArcGIS Notebook Server, debe configurarse para que funcione con Mirantis Container Runtime.
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 deben configurarse 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
Esri proporciona una única imagen de contenedor de Windows a 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.
Nota:
Existen limitaciones en cuanto al número de contenedores que se pueden ejecutar cuando se utilizan contenedores de Windows con Hyper-V. Consulte estas preguntas frecuentes de Microsoft 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:
En la versión 11.0, existe una limitación conocida que puede resultar en WinError 1455 al importar la biblioteca torch o bibliotecas de Pythonque tienen torch como dependencia.
Nota:
fiona, rasterstats y rasterio no están instalados en los contenedores de Windows.
Configurar el software de requisito previo
Antes de instalar ArcGIS Notebook Server, debe instalar y configurar el siguiente software de requisito previo.
Requisitos del sistema
Se deben cumplir los siguientes requisitos del sistema para instalar ArcGIS Notebook Server con contenedores de Windows:
- Windows Server 2022 es el único sistema operativo compatible con ArcGIS Notebook Server con contenedores de Windows.
- ArcGIS Notebook Server con contenedores de Windows requiere Mirantis Container Runtime versión 20.10 o posterior.
- Hyper-V es opcional, según el modo de aislamiento de tiempo de ejecución elegido para su sitio de ArcGIS Notebook Server.
- ArcGIS Notebook Server con contenedores de Windows requiere un mínimo de 75 GB de espacio en disco disponible.
- Revise los requisitos del sistema para ArcGIS Notebook Server.
Habilitar Hyper-V (opcional)
Hyper-V solo es obligatorio si tiene la intención de ejecutar contenedores de Windows en el modo de aislamiento Hyper-V.
Para habilitar Hyper-V, consulte Instalar el rol Hyper-V en Windows Server en la documentación de Microsoft.
Instalar Mirantis Container Runtime
Siga los pasos siguientes para instalar Mirantis Container Runtime en su equipo.
- Desinstale cualquier versión anterior de Docker de su equipo.
- No habilite la entidad Contenedores en su servidor local antes de instalar Mirantis Container Runtime. Si ya está habilitada, desactívela en su equipo de servidor. Consulte Instalar o desinstalar roles, servicios de roles o entidades en la documentación de Microsoft para obtener más información.
- Siga los pasos de Instalar Mirantis Container Runtime en Windows Server en la documentación de Mirantis.
- Ejecute el siguiente comando para verificar que Mirantis Container Runtime está 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
- 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. Para habilitar el puerto, 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://localhost: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.
Nota:
Cada vez que instale o actualice el componente Docker, debe reiniciar el equipo.
Instalar ArcGIS Notebook Server
Siga los pasos del tema de ayuda Instalar ArcGIS Notebook Server para instalar ArcGIS Notebook Server utilizando el asistente de instalación o la línea de comandos.
Configurar ArcGIS Notebook Server después de la instalación
Una vez completada la instalación de ArcGIS Notebook Server, ejecute la utilidad de postinstalación para instalar la imagen del contenedor de Windows. Regístrese en el programa de pruebas con funciones beta de ArcGIS Enterprise en la Esri Comunidad de Early Adopter (EAC) para descargar la imagen del contenedor de Windows. Siga los pasos siguientes para cada equipo en el que haya instalado ArcGIS Notebook Server.
- Abra la ventana de comando como administrador.
- Cambie los directorios a la carpeta de herramientas de ArcGIS Notebook Server. De forma predeterminada, la ruta es C:\Program Files\ArcGIS\NotebookServer\tools\PostInstallUtility.
- Determine si Mirantis Container Runtime está activo en su equipo ejecutando el siguiente comando:
PostInstallUtility.bat -d - Si Mirantis Container Runtime no está instalado, instálelo y configúrelo siguiendo las instrucciones proporcionadas anteriormente.
- Ejecute el comando siguiente:
> PostInstallUtility.bat -l <path of .tar.gz Docker image>
Crear un sitio de ArcGIS Notebook Server
Después de haber instalado ArcGIS Notebook Server y configurado la imagen del contenedor de Windows mediante la utilidad de postinstalación, cree un sitio de servidor siguiendo las instrucciones de Crear un sitio de ArcGIS Notebook Server.
Nota:
Si tiene la intención de implementar ArcGIS Notebook Server en varios equipos, lea la sección Consideraciones para los directorios de Notebook Server y el almacén de configuración a continuación antes de crear un sitio.
Consideraciones para los directorios de Notebook Server y el almacén de configuración
Si planea implementar ArcGIS Notebook Server en varios equipos, el directorio de contenido y el almacén de configuración deben utilizar un directorio compartido al que hace referencia una ruta UNC (Universal Naming Convention). El directorio del espacio de trabajo siempre debe utilizar una ruta UNC configurada como una red asignada, con una letra de unidad coincidente en todos los equipos que participan en el sitio, y usarla como directorio del espacio de trabajo.
Consulte la sección Configurar una unidad de red asignada para el directorio del espacio de trabajo a continuación para obtener instrucciones sobre cómo configurar una unidad de red asignada.
Habilitar una entidad de contenedor de Windows para Notebook Server
Después de crear con éxito su sitio, siga los pasos siguientes para habilitar el uso de ArcGIS Notebook Server con contenedores de Windows. Una vez que se haya creado su sitio de ArcGIS Notebook Server, inicie sesión en la API administrativa para asegurarse de que el sitio esté configurado para usar contenedores de Windows.
- Inicie sesión en el directorio administrativo de ArcGIS Notebook Server como administrador.
- Haga clic en Sistema > Propiedades.
- Haga clic en Actualizar propiedades.
- Actualice la propiedad useWindowsContainers para establecerla en true.
- Haga clic en Actualizar propiedades para guardar los cambios.
- Una vez que Notebook Server se haya reiniciado y se pueda acceder al directorio administrativo, haga clic en Notebook > Tiempos de ejecución > Restaurar tiempos de ejecución de fábrica.
https://notebook.domain.com:11443/arcgis/admin/notebooks/runtimes/restore
- Haga clic en Restaurar tiempos de ejecución de fábrica para actualizar los tiempos de ejecución Standard y Advanced de Notebook Server para usar las imágenes del contenedor de Windows.
Instalar y configurar ArcGIS Web Adaptor con ArcGIS Notebook Server
Una vez que haya creado el sitio de ArcGIS Notebook Server, debe instalar ArcGIS Web Adaptor y registrarlo con ArcGIS Notebook Server. Consulte Instalar y configurar ArcGIS Web Adaptor con ArcGIS Notebook Server para obtener más información.
Instalar y configurar datos de ejemplo de ArcGIS Notebook Server
Se requieren datos de muestra de ArcGIS Notebook Server para los notebooks de muestra seleccionados por Esri incluidos con ArcGIS Notebook Server. Consulte Instalar y configurar datos de muestra de ArcGIS Notebook Server para obtener más información.
Configurar Notebook Server con ArcGIS Enterprise Portal
Después de haber instalado ArcGIS Notebook Server, haberlo configurado con Mirantis Container Runtime, creado un sitio de servidor y registrado el sitio con un Web Adaptor, puede configurar el sitio con ArcGIS Enterprise Portal. Consulte Configurar ArcGIS Notebook Server con el portal para obtener más información.
Unir equipos adicionales al sitio de ArcGIS Notebook Server
ArcGIS Notebook Server admite sitios de varios equipos. En un sitio de varios equipos, cada equipo debe tener la misma configuración, con el mismo SO, la misma configuración de Mirantis Container Runtime y la unidad de red asignada con la misma letra de unidad para el directorio del espacio de trabajo. Consulte la sección Instalar y configurar un sitio de varios equipos del tema Unir equipos adicionales a un sitio de ArcGIS Notebook Server para obtener más información.
Configurar una unidad de red asignada para el directorio del espacio de trabajo
Este es un proceso opcional que solo es necesario si planea configurar un sitio de Notebook Server de varios equipos.
- Cree un recurso compartido de UNC para el directorio del espacio de trabajo de ArcGIS Notebook Server en un equipo separado al que pueda acceder Notebook Server.
Nota:
Este directorio debe tener acceso de lectura y escritura a la cuenta de ejecución de Windows de ArcGIS Notebook Server. Se recomienda crear un recurso compartido de UNC para el directorio del espacio de trabajo de ArcGIS Notebook Server en un equipo separado del equipo que participa en el sitio de ArcGIS Notebook Server. Hay un problema conocido en el que los recursos compartidos de SMB creados en el mismo equipo que Notebook Server se desconectan al reiniciar el equipo. - En el equipo de Notebook Server, abra una ventana de PowerShell como administrador.
- Guarde la contraseña de su cuenta de usuario de ArcGIS Notebook Server como una cadena de caracteres segura para usar el siguiente comando más tarde:
$password = ConvertTo-SecureString '<password>' -AsPlainText -Force - Agregue soporte de credenciales a las funciones de PowerShell:
$credential = New-Object System.Management.Automation.PSCredential('<domain\username>', $password) - Monte la carpeta con el conjunto de indicadores persistentes:
New-SmbGlobalMapping -Persistent $true -RemotePath <shared folder path> -Credential $credential -LocalPath <unassigned drive letter>: - Repita los pasos del 2 al 5 en todos los equipos que participan en el sitio de ArcGIS Notebook Server y asigne la misma letra de unidad para la unidad asignada en todos los equipos.
- Utilice la unidad de red compartida creada en el paso anterior para configurar el directorio del espacio de trabajo al crear el sitio de ArcGIS Notebook Server.
Ampliar el tiempo de ejecución de un notebook
Consulte Ampliar un tiempo de ejecución de notebook para obtener más información.
Después de seguir con éxito los pasos de este tema, tendrá una implementación de ArcGIS Notebook Server configurada con contenedores de Windows.