Servicios de Notebook le permite implementar varios métodos de automatización de flujos de trabajo, incluida la automatización a través de notebooks programados, webhooks y sus scripts personalizados con la API administrativa Ejecutar notebook.
Nota:
Para automatizar un notebook con tareas programadas, webhooks o la API Ejecutar notebook, el notebook debe usar un tiempo de ejecución de la versión 3.0 o posterior.
Programar tareas de notebook
Los autores de notebooks pueden programar ArcGIS Notebooks para su ejecución automática en un momento dado en el futuro, ya sea una vez o de forma recurrente. La creación de tareas para programar notebooks permite automatizar flujos de trabajo rutinarios, ejecutar procesos intensivos en datos fuera de las horas punta de uso y actualizar datasets regularmente. Por ejemplo, puede programar un notebook para hacer lo siguiente:
- Importar datos de una fuente en línea actualizada mensualmente, limpiar automáticamente los datos y aplicar las transformaciones necesarias y mover los datos a su espacio de trabajo.
- Ejecutar un flujo de trabajo de análisis de big data que requiera una gran potencia de procesamiento durante la noche, cuando los recursos de su equipo no se utilicen.
- Administrar los usuarios que hayan creado cuentas en su organización durante la semana anterior y enviarse la lista de los mismos en un correo electrónico.
Puede crear una o varias tareas para un notebook. De forma predeterminada, el autor o administrador del notebook puede crear un máximo de 20 tareas. Si se cambia la propiedad de un notebook, las tareas asociadas a ese notebook se desactivarán y se asignarán al nuevo propietario.
Las tareas programadas le permiten parametrizar notebooks. Cuando un notebook está parametrizado, le permite escribir código genérico que se puede adaptar a distintas entradas sin su interacción. Los parámetros elegidos se insertan en el notebook cuando se ejecuta una tarea y se pueden guardar opcionalmente en el notebook. Por ejemplo, un notebook parametrizado se puede usar para generar informes de contaminación del aire a nivel de región de forma recurrente. El notebook puede tener varias tareas programadas, una para cada región que se estudiará y, para cada tarea, se pueden introducir entradas parametrizadas en el notebook, como el nombre de la ciudad y el tipo de contaminación.
Nota:
Los administradores pueden ver los detalles, editar, pausar y reanudar, o eliminar cada tarea activa del cuaderno en el sitio desde la ventana Administrar tareas.
Puede configurar la tarea para guardar el estado del notebook en el elemento de notebook original una vez completada.
Se guardará una vista HTML estática del notebook para cada tarea programada que se ejecute.
Al utilizar la ventana Administrar tareas desde la página de inicio de los servicios de notebook, los administradores pueden ver detalles, editar, pausar y reanudar o eliminar cada tarea de notebook activa en el sitio. Los administradores y autores de notebooks con el privilegio programado del notebook pueden ver detalles, editar, pausar y reanudar, o eliminar una tarea del notebook en la página de detalles del notebook o en el panel de tareas del editor del notebook.
Si aún se está ejecutando una ejecución anterior de una tarea, se omitirá la ejecución de una nueva tarea programada. Por ejemplo, si una tarea está programada para ejecutarse cada 15 minutos, pero una instancia de esa tarea se ejecuta durante 20 minutos, se omitirá la siguiente ejecución programada. Si esto ocurre regularmente, el propietario de la tarea debe ajustar el intervalo de tiempo programado para que no se ejecute ninguna superposición entre ellas.
Para obtener más información sobre las tareas programadas de notebook, consulte el tema de ayuda Programar una tarea de notebook.
Límites de tareas programadas
Existen ciertos límites de usuario y organizativos relacionados con las tareas programadas del notebook.
Cambiar ejecuciones de notebook simultáneas automatizadas máximas (maxAutomatedNotebookJobsPerManager)
Cuando un notebook se ejecuta a través de una tarea programada, webhook o la API Ejecutar notebook, Servicios de notebook de automáticamente abre una nueva implementación de y ejecuta el notebook sin ninguna interacción de usuario. De forma predeterminada, Servicios de Notebook están configurados para ejecutar un máximo de 10 ejecuciones simultáneas de Notebook por cada implementación del servicio de automatización de notebook en los equipos de . Teniendo en cuenta los recursos disponibles en el clúster de Kubernetes, un administrador puede ajustar este límite modificando la propiedad de configuración maxAutomatedNotebookJobsPerManager de los Servicios de Notebook. Cualquier solicitud de notebook automatizada enviada después de exceder este límite se agregará a una cola y se ejecutará una vez que la cantidad de ejecuciones de tareas automatizadas caiga por debajo de este límite. Las tareas en cola fallarán si el tiempo de espera excede el tiempo de expiración.
Nota:
Esto no limita la cantidad de notebooks que se ejecutan de forma interactiva desde el editor de notebooks.
Puede cambiar el límite maxAutomatedNotebookJobsPerManager siguiendo los pasos siguientes.
Nota:
Aumentar el límite puede resultar en el uso de recursos adicionales en el equipo de nodos de .
- Inicie sesión en su portal API de administrador de ArcGIS Enterprise como administrador.
- Haga clic en Notebooks > Configuración > Actualizar configuración.
- Haga clic en Ajustes > Sitio.
- Cambie el valor de la propiedad maxAutomatedNotebookJobsPerManager.
- Haga clic en Actualizar configuración de Notebook.
Máximo de tareas de notebook activas programadas por usuario
Cada autor de notebook con el privilegio para programar notebooks puede crear hasta un máximo de 20 tareas de notebook activas. Una vez alcanzado este límite, el usuario no puede crear nuevas tareas programadas. Se puede crear una nueva tarea una vez que una tarea existente cambia de Activa a Completada, Fallida o Inactiva. Este límite se puede cambiar actualizando la propiedad ExecuteNotebooksUserLimit mediante la operación Actualizar límites en la API de API de administrador de ArcGIS Enterprise.
Máximo de tareas de notebook activas programadas por organización
El número máximo de tareas de notebook activas programadas para una organización está limitado a 200. Este límite representa el número total de tareas activas que pueden ser propiedad de todos los usuarios de una organización. Una vez alcanzado este límite, los usuarios no pueden crear nuevas tareas de notebook programadas. Este límite se puede cambiar actualizando la operación ExecuteNotebooksOrgLimitActualizar límites en la API de API de administrador de ArcGIS Enterprise.
Número de resultados informados para una tarea programada
Los resultados de una tarea se informan y mantienen durante 30 ejecuciones. Cualquier tarea ejecutada antes de las 30 ejecuciones más recientes de una tarea se elimina de forma permanente. Este límite se puede cambiar actualizando la propiedad TaskRunHistoryCount mediante la operación Actualizar límites en la API de API de administrador de ArcGIS Enterprise.
Fallo automático de una tarea
Cualquier tarea que falle cinco veces consecutivas pasará automáticamente a un estado fallido y ya no se ejecutará. El propietario de la tarea debe asegurarse de que el notebook se puede ejecutar correctamente sin que intervenga el usuario antes de reactivar la tarea. Para garantizar que las tareas sigan ejecutándose, el propietario de la tarea debe identificar y rectificar el error y cambiar la tarea al estado Activo. Este límite se puede cambiar actualizando la propiedad FailedRunsDisableTask mediante la operación Actualizar límites en la API de API de administrador de ArcGIS Enterprise.
Ejecutar la API del notebook
Los administradores y los creadores de notebooks también pueden automatizar un notebook para que se ejecute sin interacción del usuario con la operación Ejecutar notebook en el API de administrador de ArcGIS Enterprise. Esta operación ejecutará automáticamente un notebook cuando se invoque, pero si utiliza un script personalizado, puede programar que la ejecución automática se produzca a una hora determinada o en un horario regular. También puede utilizar un trabajo de cron o un programador de Windows para programar que la operación Ejecutar notebook se ejecute a una hora determinada o según un intervalo recurrente.
Para más información, consulte el tema de la operación Ejecutar notebook en la guía de referencia del Directorio de administrador.