Programa una ejecución de notebook
En esta página, se muestra cómo usar el ejecutor de Vertex AI Workbench para ejecutar un archivo de notebook de Python con una programación por hora.
Antes de comenzar
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Notebooks and Vertex AI APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Notebooks and Vertex AI APIs.
Roles obligatorios
Para garantizar que la cuenta de servicio de tu instancia tenga los permisos necesarios para interactuar con el ejecutor de Vertex AI Workbench, pídele a tu administrador que le otorgue a la cuenta de servicio de tu instancia el rol de IAM de Visualizador de notebooks (roles/notebooks.viewer
) en el proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para interactuar con el ejecutor de Vertex AI Workbench. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para interactuar con el ejecutor de Vertex AI Workbench:
-
Para enumerar las ejecuciones, haz lo siguiente:
notebooks.executions.list
Es posible que tu administrador también pueda otorgar estos permisos a la cuenta de servicio de tu instancia con roles personalizados o con otros roles predefinidos.
Crea una instancia y un archivo de notebook de ejemplo
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())
Para asegurarte de que se haya guardado el archivo del notebook, selecciona Archivo > Guardar notebook.
Programa una ejecución
En la consola de Google Cloud, ve a la página Instancias.
Junto al nombre de la instancia, haz clic en Abrir JupyterLab.
Tu instancia de Vertex AI Workbench abre JupyterLab.
En el Navegador de archivos de la
, haz doble clic en el archivo de notebook de ejemplo para abrirlo.Haz clic en el botón Ejecutar.
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
.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.
Haz clic en Enviar.
Tu archivo de notebook se ejecuta de forma automática según la programación que establezcas.
Cuando finalices las tareas que se describen en este documento, puedes borrar los recursos que creaste para evitar que continúe la facturación. Para obtener más información, consulta Cómo realizar 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
En el menú de navegación de JupyterLab, haz clic en el ícono Ejecutor de notebooks.
Haz clic en la pestaña Ejecuciones.
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
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.
Haz clic en la pestaña Ejecuciones.
Junto a la ejecución que deseas compartir, haz clic en el menú de opciones de
y selecciona Compartir el resultado de la ejecución.Sigue las instrucciones del diálogo para otorgar a los usuarios acceso al resultado de la ejecución.
Importa el notebook ejecutado a JupyterLab
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.
Haz clic en la pestaña Ejecuciones.
Junto a la ejecución que deseas importar, haz clic en el menú de opciones
y selecciona Importar notebook ejecutado.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 consola de Google Cloud 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.
Console
En la consola de Google Cloud, ve a la página Programas.
En el programa que deseas ver, haz clic en el nombre del programa.
En la página Detalles del programa, puedes ver las últimas cinco ejecuciones del programa.
Junto al nombre de una ejecución, haz clic en Ver resultado para abrir el archivo de notebook ejecutado.
El ejecutor abre el resultado en una pestaña nueva del navegador.
JupyterLab
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.
Haz clic en la pestaña Programaciones.
En la ejecución que deseas ver, haz clic en Ver resultado de la ejecución más reciente.
El ejecutor abre el resultado en una pestaña nueva del navegador.
Borra un programa
Borrar una programación no borra las ejecuciones que se generaron a partir de esa programación.
Console
En la consola de Google Cloud, ve a la página Programas.
Selecciona el programa que deseas borrar.
Haz clic en
Borrar.
JupyterLab
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.
Haz clic en la pestaña Programaciones.
Haz clic en el nombre del programa. Se abrirá la página Detalles del programa de ese programa en la consola de Google Cloud.
Haz clic en
Borrar.
Realiza una limpieza
Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.
Borra la instancia
En la consola de Google Cloud, ve a la página Instancias.
Selecciona la instancia que deseas borrar.
Haz clic en
Borrar.
Borra el proyecto
Si usaste recursos fuera de la instancia de Vertex AI Workbench, como el bucket de Cloud Storage necesario para crear una programación, te recomendamos borrar el proyecto a fin de evitar que se generen más cargos.
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.