Configurar servicios de notebook

Puede utilizar los servicios de notebooks para crear y automatizar flujos de trabajo de notebooks.

Licencia:

Esta capacidad está disponible en dos niveles de licencia:

• La licencia de ArcGIS Enterprise on Kubernetes incluye una licencia de ArcGIS Notebook Services. Esta licencia permite a los miembros de la organización crear notebooks utilizando el tiempo de ejecución de ArcGIS Notebook Python 3 Standard y automatizar los flujos de trabajo de los notebooks utilizando tareas programadas, webhooks y herramientas web.
• Una licencia de ArcGIS Notebook Services Advanced está disponible como una capacidad premium y proporciona acceso al tiempo de ejecución de ArcGIS Notebook Python 3 Advanced con capacidades adicionales de ArcPy más allá de lo que se proporciona en la licencia de ArcGIS Notebook Services.

Nota:

Para admitir los servicios de notebook, cualquier proxy inverso o equilibrador de carga externo debe ser capaz de transmitir tráfico de WebSocket a los destinos de back-end y tener requisitos definidos para que las sesiones permanezcan abiertas durante 10 minutos.

Introducción a los servicios de notebook

Los notebooks ofrecen una versátil interfaz web de Python para realizar análisis de datos geoespaciales. Con los notebooks, puede realizar análisis, automatizar flujos de trabajo y ver al momento los resultados de los datos y los análisis en un contexto geográfico.

Los notebooks son un entorno eficiente y moderno que combina código, visualizaciones y mapas al vuelo y herramientas de datos. En el editor de notebooks, puede escribir, documentar y ejecutar código de Python en un único lugar.

Antes de habilitar los servicios de notebook, verifique que su administrador ha asignado suficiente cuota de recursos y nodos trabajadores para admitir esta capacidad premium.

Configurar servicios de notebook

Es posible que los siguientes pasos de configuración requieran hacer cambios en la forma en que ha implementado ArcGIS en su organización; revíselas detenidamente antes de continuar.

Los servicios de notebook requieren que el pod runAsUser tenga permisos de lectura y escritura en el recurso compartido de red asociado. En algunos proveedores, puede que se requiera permitir que otras personas tengan esos permisos, mientras que en otros casos la ubicación compartida puede actualizarse para permitir que el Id. de usuario predeterminado (117932853) sea el propietario del directorio principal y de cualquier subdirectorio/archivo. Si se permite el acceso de lectura/escritura a otras personas, deben utilizarse rangos de IP adecuados como control de seguridad en la configuración NFS. Para los clústeres que aplican la asignación arbitraria de Id. de usuario durante la admisión/programación del pod, el Id. de usuario debe establecerse en un valor estático y los permisos deben ajustarse en consecuencia.

Habilitar servicios de notebook

Para habilitar los servicios de notebook, debe configurar un espacio de trabajo de notebook y habilitar la capacidad en ArcGIS Enterprise Manager.

1. En ArcGIS Enterprise Manager, haga clic en el botón Capacidades de la barra lateral.

   Aparece la página de capacidades.

2. Active el botón de alternancia de los Servicios de notebook.

   Aparecerá el cuadro de diálogo Configurar espacio de trabajo y le pedirá que especifique los valores necesarios. El espacio de trabajo se utilizará para almacenar los archivos asociados con los notebooks de cada miembro de la organización.

3. Proporcione la información obligatoria:
   • • Tipo de volumen: seleccione Dinámico o Estático para especificar cómo desea proporcionar un volumen persistente para el espacio de trabajo. Utilice Estático cuando el PVC debe vincularse a un PV existente. Utilice Dinámico cuando se deba proporcionar un nuevo PV a través de la clase de almacenamiento especificada. Consulte las consideraciones sobre el Aprovisionamiento dinámico y el Aprovisionamiento estático para obtener más información.

       Nota:

       El PV de este espacio de trabajo debe ser de tipo FileSystem y admitir el modo de acceso ReadWriteMany (RWX). Antes de configurar un espacio de trabajo de notebook, compruebe que el PV que asigna a este espacio de trabajo admite el modo de acceso RWX. Además, para admitir el PV, es posible que tenga que instalar un controlador de soporte en su clúster de Kubernetes.

     • Nombre de volumen: si se elige Estático, debe proporcionar un nombre de volumen.
     • Nombre de clase de almacenamiento: especifique su propio nombre de clase de almacenamiento o si ha definido una clase de almacenamiento, especifique el nombre de clase de almacenamiento para el volumen.

       Nota:

       El nombre de clase de almacenamiento es obligatorio para Dinámico y opcional para Estático.

       Nota:

       Al vincularse a un PV existente que no tenga definida ninguna clase de almacenamiento, deje en blanco el nombre de la clase de almacenamiento. Si se configura una clase de almacenamiento predeterminada en el clúster, el controlador de admisión DefaultStorageClass agrega la clase de almacenamiento predeterminada e impide que el PVC se vincule. En este caso, los administradores deben agregar una especificación de clase de almacenamiento al PV o eliminar la configuración de la clase de almacenamiento predeterminada.

     • Tamaño (GiB): define el tamaño del PV. El tamaño mínimo es 100 GiB. El valor debe coincidir con el tamaño del PV existente al utilizar la vinculación estática. Si el valor es mayor que el tamaño del PV existente, el PVC no se vinculará al PV.

       Nota:

       Solo puede configurarse un espacio de trabajo de notebook para su organización. Su tamaño de almacenamiento está limitado al valor especificado en el momento de su creación. Asegúrese de elegir un espacio de trabajo de tamaño suficiente para satisfacer sus necesidades actuales y futuras.

     • Haga clic en Guardar.

   Aparecerá un mensaje indicando que el proceso de activación puede llevar algún tiempo.

   Se envía una solicitud para habilitar los servicios de notebook. Este proceso validará los requisitos previos y activará los recursos de apoyo. Se iniciará automáticamente un servicio de automatización de notebook.

Si la capacidad no se activa, repita los pasos anteriores para asegurarse de que el área de trabajo se ha configurado, que la licencia de los servicios de notebook es válida y está disponible, y que se han iniciado los servicios del sistema. Revise los registros para identificar los requisitos de esta capacidad.

Opcionalmente, puede desplegar un deamonSet para precargar imágenes de servicios de notebook. Esto ayudará a mejorar el tiempo que se tarda en abrir un notebook por primera vez. La carga inicial de un notebook se establece en un tiempo de espera de 1 minuto.

Los servicios de notebook ya están configurados. Puede empezar a utilizar notebooks en su organización. Vea cómo crear un notebook y publicar un notebook como herramienta web.

Además, vea cómo ajustar la configuración de la capacidad de los servicios de notebook.

Configuración de los servicios de notebook

Una vez activados los servicios de notebook, puede ver y editar los ajustes relacionados, por ejemplo, los recursos de soporte para los tiempos de ejecución aplicables, el tamaño de WebSocket, las instantáneas máximas por elemento de notebook, etc.

La capacidad de servicio de notebook incluye tres pestañas principales en las que puede ver o editar la configuración: Descripción general, Propiedades y Tiempos de ejecución.

• Resumen: determine el estado del servicio de automatización de notebooks, el número de despliegues de notebooks en ejecución y la clase de almacenamiento asignada al espacio de trabajo dedicado al notebook.
• Propiedades: gestiona los límites relacionados con los despliegues de notebooks tanto interactivos como automatizados.
• Tiempos de ejecución: vea y edite la configuración de los tiempos de ejecución del servicio de notebook disponible.

Ver y editar propiedades

Las siguientes propiedades se pueden ver y editar en ArcGIS Enterprise Manager:

• Tamaño de WebSocket (MB): el tamaño máximo (en megabytes) de un paquete que se puede pasar entre el servidor y los navegadores del cliente utilizando el protocolo WebSocket. WebSocket se utiliza para facilitar una comunicación bidireccional segura y eficiente con los clientes. El valor predeterminado de esta propiedad es 16 MB. Es posible que deba aumentar este límite si un notebook pasa una pieza de datos particularmente grande al sitio del servidor.
• Umbral de notebook inactivo (minutos): esta propiedad regula cuándo se cierran los notebooks inactivos. Los notebooks que están abiertos pero que han estado inactivos por esta cantidad de tiempo (en minutos) se cierran automáticamente. El kernel del notebook se detiene. El valor predeterminado es 7 minutos.
• Umbral de despliegue vacío: esta propiedad establece el tiempo que un despliegue de notebook puede permanecer abierto (en minutos) sin ejecutar ningún notebook activo. Una vez alcanzado este valor, el contenedor se cierra automáticamente. El valor predeterminado es 60 minutos. Al igual que con el umbral de notebook inactivo, es posible que desee reducir este valor para conservar los recursos.
• Instantáneas máximas por elemento de notebook: esta propiedad limita el número de instantáneas permitidas por elemento de notebook. El valor predeterminado es 5.

Siga estos pasos para ver y editar las propiedades.

1. Inicie sesión en ArcGIS Enterprise Manager como administrador.
2. Haga clic en la página Capacidades.
3. En la tarjeta de Servicios de notebook, haga clic en Configuración.
4. Haga clic en la página Propiedades.

   Si cambia alguno de los valores de la configuración, el botón Guardar se vuelve disponible.

5. Haga clic en Guardar para conservar los cambios.

Ver y editar tiempos de ejecución

Como administrador, puede actualizar el máximo de CPU y memoria disponibles para cada contenedor si modifica los recursos que usa cada tiempo de ejecución del notebook de forma predeterminada. Si hay varios usuarios creando notebooks al mismo tiempo, puede supervisar el uso y ajustar esta configuración como sea necesario mediante ArcGIS Enterprise Manager.

Los siguientes aspectos del tiempo de ejecución pueden verse y editarse en ArcGIS Enterprise Manager:

Siga estos pasos para ver y editar los valores de tiempo de ejecución.

1. Inicie sesión en ArcGIS Enterprise Manager como administrador.
2. Haga clic en la página Capacidades.
3. En la tarjeta de Servicios de notebook, haga clic en Configuración.
4. Haga clic en la página Tiempos de ejecución.

   Si cambia alguno de los valores de la configuración, el botón Guardar se vuelve disponible.

5. Haga clic en Guardar para conservar los cambios.