Programa una ejecución de notebook

Crea una instancia y un archivo de notebook de ejemplo

1. Crea una instancia.

2. Abre JupyterLab.

3. Abre un archivo de notebook nuevo.

4. En la primera celda del archivo de notebook, ingresa lo siguiente:

   # Import datetime
   import datetime
   
   # Get the time and print it
   datetime.datetime.now()
   print(datetime.datetime.now())

5. Para asegurarte de que se haya guardado el archivo del notebook, selecciona Archivo > Guardar notebook.

Otorga permisos a la cuenta de servicio de la instancia

Para garantizar que la cuenta de servicio de tu instancia tenga los permisos necesarios para interactuar con el ejecutor de Agent Platform Workbench, pídele a tu administrador que le otorgue a la cuenta de servicio de tu instancia los siguientes roles de IAM en el proyecto:

• Ejecutor de notebooks (roles/notebooks.runner)
• Administrador de almacenamiento (roles/storage.admin)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Es posible que tu administrador también pueda otorgar a la cuenta de servicio de tu instancia los permisos necesarios mediante roles personalizados o con otros roles predefinidos.

Limitaciones

Ten en cuenta la siguiente limitación cuando programes la ejecución de un notebook en una instancia de JupyterLab 4:

• Cuando se programa la ejecución de un notebook en JupyterLab 4, Agent Platform Workbench almacena una copia del notebook en su estado actual en Cloud Storage y, luego, ejecuta esta copia del notebook según la programación. Si editas el notebook original, debes crear una nueva programación para ejecutar la versión actualizada del notebook.

Programa una ejecución

1. En la consola de Cloud de Confiance , ve a la página Instancias.

   Ir a Instancias

2. Junto al nombre de la instancia, haz clic en Abrir JupyterLab.

   Tu instancia de Agent Platform Workbench abre JupyterLab.

3. En el Navegador de archivos de la folder, haz doble clic en el archivo de notebook de ejemplo para abrirlo.

4. Haz clic en el botón Ejecutar.

5. En el diálogo Envía notebooks a un ejecutor, en el campo Tipo, selecciona Ejecuciones recurrentes basadas en Scheduler.

   De forma predeterminada, el ejecutor ejecuta tu archivo de notebook cada hora en el minuto 00.

6. En Opciones avanzadas, ingresa un nombre para tu bucket en el campo Bucket de Cloud Storage y, luego, haz clic en Crear y seleccionar. El ejecutor almacena el resultado de tu notebook en este bucket de Cloud Storage.

7. Haz clic en Enviar.

   Tu archivo de notebook se ejecuta de forma automática según la programación que establezcas.

Cuando completes las tareas que se describen en este documento, podrás borrar los recursos que creaste para evitar que se te siga facturando. Para obtener más información, consulta Realiza una limpieza.

Visualiza, comparte e importa un archivo de notebook ejecutado

Si usas la interfaz de JupyterLab de tu instancia, puedes ver el resultado del notebook, compartir los resultados con otros y, luego, importar el archivo del notebook ejecutado a JupyterLab.

Observa los resultados de la ejecución

1. En el menú de navegación de JupyterLab, haz clic en el ícono Ejecutor de notebooks.

2. Haz clic en la pestaña Ejecuciones.

3. En la ejecución que deseas ver, haz clic en Ver resultado.

   El ejecutor abre el resultado en una pestaña nueva del navegador.

Comparte los resultados de la ejecución

1. En la interfaz de usuario de JupyterLab de tu instancia, en el menú de navegación, haz clic en el botón Ejecutor de notebooks.

2. Haz clic en la pestaña Ejecuciones.

3. Junto a la ejecución que deseas compartir, haz clic en el menú de opciones de more_vert y selecciona Compartir el resultado de la ejecución.

4. Sigue las instrucciones del diálogo para otorgar a los usuarios acceso al resultado de la ejecución.

Importa el notebook ejecutado a JupyterLab

1. En la interfaz de usuario de JupyterLab de tu instancia, en el menú de navegación, haz clic en el botón Ejecutor de notebooks.

2. Haz clic en la pestaña Ejecuciones.

3. Junto a la ejecución que deseas importar, haz clic en el menú de opciones more_vert y selecciona Importar notebook ejecutado.

4. Si aparece el diálogo Seleccionar Kernel, selecciona el kernel que deseas abrir el notebook.

   El ejecutor abre el archivo de notebook ejecutado en JupyterLab y almacena este archivo de notebook en el navegador de archivos de JupyterLab en una carpeta llamada imported_notebook_jobs.

Ve o borra un programa

Puedes ver y borrar los programas mediante la Cloud de Confiance consola o la interfaz de usuario de JupyterLab de tu instancia.

Ve una programación

Consulta una programación para ver la configuración de frecuencia de la programación o ver los cinco resultados más recientes de la ejecución del archivo del notebook.

Borra un programa

Borrar una programación no borra las ejecuciones que se generaron a partir de esa programación.