Programar una ejecución de cuadernos gestionados

Programar una ejecución de cuadernos gestionados

Los notebooks gestionados de Vertex AI Workbench están obsoletos. El 14 de abril del 2025, dejaremos de ofrecer asistencia para los cuadernos gestionados y se eliminará la opción de crear instancias de cuadernos gestionados. Las instancias que ya tengas seguirán funcionando, pero no estarán disponibles los parches, las actualizaciones ni las mejoras. Para seguir usando Vertex AI Workbench, te recomendamos que migres tus instancias de cuadernos gestionados a instancias de Vertex AI Workbench.

En esta página se muestra cómo usar el ejecutor de cuadernos gestionados de Vertex AI Workbench para ejecutar un archivo de cuaderno de Python cada hora.

Antes de empezar

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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Roles obligatorios

Para asegurarte de que la cuenta de servicio de tu instancia tiene los permisos necesarios para interactuar con el ejecutor de Vertex AI Workbench, pide a tu administrador que conceda a la cuenta de servicio de tu instancia los siguientes roles de gestión de identidades y accesos en el proyecto:

Importante: Debes asignar estos roles a la cuenta de servicio de tu instancia, no a tu cuenta de usuario. Si no se conceden los roles a la entidad correcta, pueden producirse errores de permisos.
• Lector de cuadernos (roles/notebooks.viewer)
• Usuario de Vertex AI (roles/aiplatform.user)
• Administrador de almacenamiento (roles/storage.admin)

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Es posible que tu administrador también pueda conceder a la cuenta de servicio de tu instancia los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Crear una instancia de cuadernos gestionados y un archivo de cuaderno de ejemplo

1. Crea una instancia de cuadernos gestionados.

2. Abre JupyterLab.

3. Abre un archivo de cuaderno nuevo.

4. En la primera celda del archivo del cuaderno, introduce lo siguiente:

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

5. Para asegurarte de que el archivo del cuaderno se guarda, selecciona Archivo > Guardar cuaderno.

Programar una ejecución

1. En la Google Cloud consola, ve a la página Notebooks gestionados.

   Ir a Cuadernos gestionados

2. Junto a la instancia de cuadernos gestionados que quieras usar, haz clic en Abrir JupyterLab.

   Tu instancia de cuadernos gestionados abre JupyterLab.

3. En el  Explorador de archivos, haz doble clic en el archivo de ejemplo del cuaderno para abrirlo.

4. Haz clic en el botón  Ejecutar.

5. En el cuadro de diálogo Enviar cuadernos a Executor, en el campo Tipo, seleccione Ejecuciones periódicas basadas en una programación.

   De forma predeterminada, el ejecutor ejecuta tu archivo de cuaderno cada hora a los 00 minutos de la hora.

6. En Opciones avanzadas, selecciona la región en la que quieras ejecutar el cuaderno.

7. En el campo Segmento de Cloud Storage, introduce un nombre para el segmento y haz clic en Crear y seleccionar. El ejecutor almacena la salida del cuaderno en el segmento de Cloud Storage.

8. Haz clic en Enviar.

   El archivo del cuaderno se ejecuta automáticamente según la programación que hayas definido.

Nota: Si se cierra la instancia de cuadernos gestionados, el ejecutor seguirá ejecutando el archivo de cuaderno según la programación.

Cuando termines las tareas que se describen en este documento, puedes evitar que se te siga facturando eliminando los recursos que has creado. Para obtener más información, consulta la sección Limpiar.

Ver, compartir e importar un archivo de cuaderno ejecutado

Con la interfaz de JupyterLab de tu instancia de cuadernos gestionados, puedes ver el resultado de tu cuaderno, compartir los resultados con otros usuarios e importar el archivo del cuaderno ejecutado en JupyterLab.

Nota: Para usar la consola Google Cloud para ver y compartir los resultados de la ejecución, en la página Ejecuciones, haz clic en Ejecuciones

.

Ver los resultados de la ejecución

1. En el menú de navegación de JupyterLab, haz clic en el botón  Ejecutor de cuaderno.

2. Haz clic en la pestaña Ejecuciones.

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

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

Compartir los resultados de la ejecución

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

2. Haz clic en la pestaña Ejecuciones.

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

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

Importar el cuaderno ejecutado en JupyterLab

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

2. Haz clic en la pestaña Ejecuciones.

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

4. Si aparece el cuadro de diálogo Seleccionar kernel, selecciona el kernel con el que quieras abrir el cuaderno.

   El ejecutor abre el archivo de cuaderno ejecutado en JupyterLab y lo almacena en el explorador de archivos de JupyterLab, en una carpeta llamada imported_notebook_jobs.

Ver o eliminar una programación

Puedes ver y eliminar programaciones mediante la Google Cloud consola o la interfaz de usuario de JupyterLab de tu instancia de cuadernos gestionados.

Ver una programación

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

Consola

1. En la Google Cloud consola, ve a la página Programaciones.

   Ir a Horarios

2. Selecciona la región en la que quieras ver las programaciones.

3. En la página Detalles de la programación que quieras abrir, haz clic en el nombre de la programación.

   En la página Detalles de la programación, puedes ver las últimas cinco ejecuciones de la programación.

4. Junto al nombre de una ejecución, haz clic en Ver resultado para abrir el archivo de cuaderno ejecutado.

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

JupyterLab

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

2. Haz clic en la pestaña Programaciones.

3. En la ejecución que quieras ver, haz clic en Ver el resultado de la última ejecución.

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

Eliminar una programación

Al eliminar una programación, no se eliminan las ejecuciones que se hayan generado a partir de ella.

Consola

1. En la Google Cloud consola, ve a la página Programaciones.

   Ir a Horarios

2. Selecciona la región que contenga la programación que quieras eliminar.

3. Selecciona la programación que quieras eliminar.

4. Haz clic en  Eliminar.

JupyterLab

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

2. Haz clic en la pestaña Programaciones.

3. Al final del nombre de la programación, haz clic en el icono  Abrir en nuevo. Se abrirá la página Detalles de la programación de esa programación en la consola Google Cloud .

4. Haz clic en  Eliminar.

Limpieza

Para evitar que se apliquen cargos en tu cuenta de Google Cloud por los recursos utilizados en esta página, sigue estos pasos.

Eliminar la instancia

1. En la Google Cloud consola, ve a la página Notebooks gestionados.

   Ir a Cuadernos gestionados

2. Selecciona la región que contiene tu instancia.

3. Selecciona la instancia de cuadernos gestionados que quieras eliminar.

4. Haz clic en  Eliminar.

Eliminar el proyecto

Si has usado recursos fuera de tu instancia de cuadernos gestionados, como el segmento de Cloud Storage necesario para crear una programación, puede que te interese eliminar el proyecto para evitar que se te apliquen cargos adicionales.

Precaución: Eliminar un proyecto tiene los siguientes efectos:

• Se elimina todo el contenido del proyecto. Si has usado un proyecto que ya existía para las tareas de este documento, cuando lo elimines, también se eliminará cualquier otro trabajo que hayas realizado en él.
• Se pierden los IDs de proyecto personalizados. Cuando creaste este proyecto, es posible que hayas creado un ID de proyecto personalizado que quieras usar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, elimina los recursos seleccionados dentro del proyecto en lugar de eliminar todo el proyecto.

Si tienes previsto consultar varias arquitecturas, tutoriales o guías de inicio rápido, reutilizar los proyectos puede ayudarte a no superar los límites de cuota de proyectos.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Siguientes pasos

• Más información sobre cómo crear una instancia de cuadernos gestionados