Crea una instancia de cuadernos gestionados con la Google Cloud consola

Crea una instancia de cuadernos gestionados con la Google Cloud consola

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.

Aprende a crear una instancia de cuadernos gestionados de Vertex AI Workbench y a abrir JupyterLab mediante la Google Cloud consola. En esta página también se describe cómo detener, iniciar, restablecer o eliminar una instancia de cuadernos gestionados.

---

Para seguir las instrucciones paso a paso de esta tarea directamente en la Google Cloud consola, haga clic en Ayúdame:

Guíame

---

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 API.

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 API

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 API.

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 API

Crear una instancia

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

   Ir a Cuadernos gestionados

2. Haz clic en  Crear.

3. En la ventana Crear instancia, en el campo Nombre, introduce my-instance.

4. Haz clic en Crear.

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.

Abrir JupyterLab

Después de crear la instancia, Vertex AI Workbench la inicia automáticamente. Cuando la instancia esté lista para usarse, Vertex AI Workbench activará el enlace Abrir JupyterLab.

1. Junto al nombre de la instancia de cuadernos gestionados, haz clic en Abrir JupyterLab.

2. En el cuadro de diálogo Autentica tu cuaderno gestionado, haz clic en el botón para obtener un código de autenticación.

3. Elige una cuenta y haz clic en Permitir. Copia el código de autenticación.

4. En el cuadro de diálogo Autentica tu cuaderno gestionado, pega el código de autenticación y haz clic en Autenticar.

   Tu instancia de cuadernos gestionados abre JupyterLab.

Abrir un archivo de cuaderno nuevo

1. Selecciona Archivo > Nuevo > Cuaderno.

2. En el cuadro de diálogo Seleccionar kernel, selecciona Python y, a continuación, haz clic en Seleccionar.

   Se abrirá el archivo del nuevo cuaderno.

Cambiar el kernel

Puedes cambiar el kernel de tu archivo de cuaderno de JupyterLab desde el menú o en el archivo.

Menú

1. En JupyterLab, en el menú Kernel, haz clic en Cambiar kernel.

2. En el cuadro de diálogo Seleccionar kernel, elige otro kernel.

3. Haz clic en Seleccionar.

En el archivo

1. En el archivo de cuaderno de JupyterLab, haz clic en el nombre del kernel.

   

2. En el cuadro de diálogo Seleccionar kernel, elige otro kernel.

3. Haz clic en Seleccionar.

Detener una instancia

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

   Ir a Cuadernos gestionados

2. Selecciona la instancia que quieras detener.

3. Haz clic en  Detener.

Iniciar una instancia

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

   Ir a Cuadernos gestionados

2. Selecciona la instancia que quieras iniciar.

3. Haz clic en  Empezar.

Restablecer una instancia

Al restablecer una instancia de forma forzada, se borra el contenido de la memoria de la instancia y se restablece su estado inicial. Para obtener más información sobre cómo funciona el restablecimiento de una instancia, consulta Restablecer una instancia.

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

   Ir a Cuadernos gestionados

2. Selecciona la instancia que quieras restablecer.

3. Haz clic en Restablecer y, a continuación, en Restablecer para confirmar la acción.

Limpieza

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

Si has creado un proyecto para obtener información sobre los cuadernos gestionados de Vertex AI Workbench y ya no lo necesitas, elimínalo.

Si has usado un proyecto, elimina los recursos que hayas creado para evitar que se apliquen cargos en tu cuenta: Google Cloud

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

   Ir a Cuadernos gestionados

2. Selecciona la fila que contiene la instancia que quieres eliminar.

3. Haz clic en  Eliminar. (En función del tamaño de la ventana, el botón Eliminar puede estar en el menú de opciones ).

4. Para confirmar la acción, haz clic en Eliminar.

Siguientes pasos

• Prueba uno de los tutoriales incluidos en tu nueva instancia de cuadernos gestionados. En el  explorador de archivos de JupyterLab, abre la carpeta tutorials y, a continuación, uno de los archivos de cuaderno.

  

• Consulta la introducción a los cuadernos gestionados.

• Para obtener más información sobre la configuración avanzada de las instancias de cuadernos gestionados, consulta Crear una instancia de cuadernos gestionados.