Conéctate a un entorno de ejecución

En esta página, se muestra cómo conectarse a un entorno de ejecución en Colab Enterprise.

Para ejecutar código en tu notebook, debes conectarte a un entorno de ejecución. Un entorno de ejecución es un recurso de procesamiento que ejecuta tu código.

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.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

Enable the APIs

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

Enable the APIs

Conéctate mediante diferentes métodos

En esta página, se muestra cómo conectarse a un entorno de ejecución mediante los siguientes métodos:

• Usa el entorno de ejecución predeterminado
• Conéctate a un entorno de ejecución existente
• Crea un entorno de ejecución

Usa el entorno de ejecución predeterminado

En esta sección, se describe cómo conectarse al entorno de ejecución predeterminado.

Roles obligatorios

Para obtener los permisos que necesitas para conectarte al entorno de ejecución predeterminado en un notebook de Colab Enterprise, pídele a tu administrador que te otorgue el rol de IAM de usuario de Colab Enterprise (roles/aiplatform.colabEnterpriseUser) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Conéctate al entorno de ejecución predeterminado

Cuando ejecutas código en un notebook por primera vez, Colab Enterprise se conecta de forma automática al entorno de ejecución predeterminado, a menos que especifiques otro diferente.

Para conectarte al entorno de ejecución predeterminado sin ejecutar el código, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Mis notebooks de Colab Enterprise.

   Ir a Mis notebooks

2. En el menú Región, selecciona la región que contiene el notebook.

3. Haz clic en el notebook que quieras abrir. Si aún no creaste un notebook, crea uno.

4. En tu notebook, haz clic en Conectar.
   

5. Si es la primera vez que te conectas a un entorno de ejecución con las credenciales de usuario final habilitadas, aparecerá un diálogo de Acceso.

   Para otorgar a Colab Enterprise acceso a tus credenciales de usuario, completa los siguientes pasos:

   1. En el cuadro de diálogo Acceder, haga clic en su cuenta de usuario.

   2. Selecciona Ver, editar, configurar y borrar tus datos de Google Cloud … para otorgar a Colab Enterprise acceso a tus credenciales de usuario.

      

   3. Haz clic en Continuar.

Colab Enterprise se conecta al entorno de ejecución predeterminado. Si el entorno de ejecución predeterminado no está en ejecución, Colab Enterprise inicia el entorno de ejecución predeterminado y, luego, se conecta a él.

Conéctate a un entorno de ejecución existente

En esta sección, se describe cómo conectarse a un entorno de ejecución existente mediante el cuadro de diálogo Conectar al entorno de ejecución de Vertex AI.

Roles obligatorios

Para obtener los permisos que necesitas para conectarte a un entorno de ejecución existente en un notebook de Colab Enterprise, pídele a tu administrador que te otorgue el rol de IAM de usuario de Colab Enterprise (roles/aiplatform.colabEnterpriseUser) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Conéctate al entorno de ejecución existente

Para conectarte a un entorno de ejecución existente, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Mis notebooks de Colab Enterprise.

   Ir a Mis notebooks

2. En el menú Región, selecciona la región que contiene el notebook.

3. Haz clic en el notebook que quieras abrir. Si aún no creaste un notebook, crea uno.

4. En el notebook, haz clic en la flecha desplegable Opciones de conexión adicionales y, luego, selecciona Conectar a un entorno de ejecución.
   

   Se abre el cuadro de diálogo Conectar al entorno de ejecución de Vertex AI.

5. En Seleccionar un entorno de ejecución, selecciona Conectar a un entorno de ejecución existente.

6. En Selecciona una opción de entorno de ejecución existente, selecciona el entorno de ejecución al que deseas conectarte. Si no hay entornos de ejecución en la lista, crea un entorno de ejecución o conéctate al entorno de ejecución predeterminado.

7. Haz clic en Conectar.

8. Si el entorno de ejecución tiene habilitadas las credenciales de usuario final y es la primera vez que te conectas a un entorno de ejecución con las credenciales de usuario final habilitadas, aparecerá un diálogo de Acceso.

   Para otorgar a Colab Enterprise acceso a tus credenciales de usuario, completa los siguientes pasos:

   1. En el cuadro de diálogo Acceder, haga clic en su cuenta de usuario.

   2. Selecciona Ver, editar, configurar y borrar tus datos de Google Cloud … para otorgar a Colab Enterprise acceso a tus credenciales de usuario.

      

   3. Haz clic en Continuar.

Colab Enterprise se conecta al entorno de ejecución. Si el entorno de ejecución no se está ejecutando, Colab Enterprise inicia el entorno de ejecución y, luego, se conecta a él.

Crea un entorno de ejecución

En esta sección, se describe cómo crear un entorno de ejecución y conectarse a él mediante el diálogo Conectar al entorno de ejecución de Vertex AI. Como alternativa, puedes crear un entorno de ejecución desde la pestaña Entornos de ejecución.

Roles obligatorios

Para obtener los permisos que necesitas para crear un entorno de ejecución en Colab Enterprise, pídele a tu administrador que te otorgue el rol de IAM de administrador de Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Crea un entorno de ejecución y conéctate a él

Para crear un entorno de ejecución y conectarte a él mediante el diálogo Conectar al entorno de ejecución de Vertex AI, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Mis notebooks de Colab Enterprise.

   Ir a Mis notebooks

2. En el menú Región, selecciona la región que contiene el notebook.

3. Haz clic en el notebook que quieras abrir. Si aún no creaste un notebook, crea uno.

4. En el notebook, haz clic en la flecha desplegable Opciones de conexión adicionales y, luego, selecciona Conectar a un entorno de ejecución.
   

   Se abre el cuadro de diálogo Conectar al entorno de ejecución de Vertex AI.

5. En Selecciona un entorno de ejecución, selecciona Crea un entorno de ejecución nuevo.

6. En el menú Plantilla de entorno de ejecución, selecciona una plantilla de entorno de ejecución. Si no hay plantillas de entorno de ejecución enumeradas, crea una plantilla de entorno de ejecución.

7. En el campo Nombre del entorno de ejecución, ingresa un nombre para tu entorno de ejecución.

8. Haz clic en Conectar.

9. Si la plantilla de entorno de ejecución que seleccionaste tiene habilitadas las credenciales de usuario final, y es la primera vez que te conectas a un entorno de ejecución con credenciales de usuario final habilitadas, aparecerá un diálogo de Acceso.

   Para otorgar a Colab Enterprise acceso a tus credenciales de usuario, completa los siguientes pasos:

   1. En el cuadro de diálogo Acceder, haga clic en su cuenta de usuario.

   2. Selecciona Ver, editar, configurar y borrar tus datos de Google Cloud … para otorgar a Colab Enterprise acceso a tus credenciales de usuario.

      

   3. Haz clic en Continuar.

Colab Enterprise inicia el entorno de ejecución predeterminado y, luego, se conecta a él.

Cómo cambiar a un entorno de ejecución predeterminado con GPUs

Si tu administrador habilitó los entornos de ejecución predeterminados con GPU o si tu cuenta de usuario tiene el permiso aiplatform.notebookRuntimeTemplates.create, puedes cambiar a un entorno de ejecución que tenga GPUs después de conectarte al entorno de ejecución predeterminado.

En tu notebook, haz clic en Cambiar a GPU.

Para obtener información sobre cómo habilitar los tiempos de ejecución predeterminados con GPUs, consulta Habilita los tiempos de ejecución predeterminados con GPUs.

Administración del entorno de ejecución

De forma predeterminada, cuando creas un entorno de ejecución, automáticamente tienes los permisos necesarios para borrar (aiplatform.googleapis.com/notebookRuntimes.delete) y comenzar (aiplatform.googleapis.com/notebookRuntimes.start) ese entorno de ejecución.

Para obtener información sobre cómo administrar tu entorno de ejecución, incluido cómo borrarlo, iniciarlo o desconectarte de él, consulta Administra entornos de ejecución.

Solucionar problemas

En esta sección, se muestra cómo resolver problemas de conexión a entornos de ejecución en Colab Enterprise.

No es posible conectarse a un entorno de ejecución

Este problema se produce por varios motivos. Consulta también No se puede conectar a un entorno de ejecución predeterminado. Las causas más comunes son las siguientes:

El navegador bloquea las cookies de terceros

El navegador que usas bloquea una cookie de terceros que Colab Enterprise usa para establecer una conexión HTTPS con el entorno de ejecución.

Para solucionar este problema, establece la configuración de tu navegador a fin de permitir la cookie de terceros DATALAB_TUNNEL_TOKEN desde el dominio *.aiplatform-notebook.googleusercontent.com.

La red bloquea el tráfico saliente a los dominios de notebook

Las reglas de firewall de la red bloquean el tráfico saliente a *.aiplatform-notebook.cloud.google.com o *aiplatform.googleapis.com.

Para resolver este problema, configura las reglas de firewall de tu red a fin de permitir el tráfico saliente a *.aiplatform-notebook.cloud.google.com y *aiplatform.googleapis.com.

No se puede conectar a un entorno de ejecución predeterminado

El siguiente error se produce cuando intentas conectarte a un entorno de ejecución predeterminado cuando no hay una plantilla de entorno de ejecución predeterminado existente.

Failed to connect to runtime

Cuando te conectas a un entorno de ejecución predeterminado que aún no se creó, Colab Enterprise primero crea una plantilla de entorno de ejecución predeterminado y, luego, usa esa plantilla para generar el entorno de ejecución predeterminado. Sin embargo, si no tienes los permisos necesarios para crear una plantilla de entorno de ejecución, Colab Enterprise no podrá crear la plantilla de entorno de ejecución predeterminada ni el entorno de ejecución predeterminado.

Para resolver este problema, pídele a tu administrador que te otorgue un rol que incluya el permiso aiplatform.notebookRuntimeTemplates.create.

El notebook tarda en conectarse al entorno de ejecución

Unos minutos después de iniciar una conexión con un entorno de ejecución, el mensaje Connecting sigue apareciendo en la esquina superior derecha del notebook y Colab Enterprise aún no se conectó al entorno de ejecución.

Para resolver este problema, espera unos minutos más. Colab Enterprise aún se está conectando a un entorno de ejecución. Conectarse a un entorno de ejecución que aún no se está ejecutando puede tardar unos minutos porque Vertex AI asigna una nueva instancia de máquina virtual (VM).

No se pudo crear un entorno de ejecución

Este problema se produce cuando no puedes crear un entorno de ejecución. Consulta también No se puede crear un entorno de ejecución predeterminado. Las causas más comunes son las siguientes:

Recursos no disponibles

El siguiente error ocurre cuando intentas crear un entorno de ejecución.

No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

Este error se produce si no hay recursos disponibles para la configuración del tipo de máquina dentro de la región de tu notebook.

Para resolver este problema, prueba una de las siguientes opciones:

• Crea un tiempo de ejecución en otra región.
• Crea una plantilla de entorno de ejecución con una configuración de tipo de máquina diferente y, luego, crea un entorno de ejecución basado en la nueva plantilla.

Ya existe un entorno de ejecución predeterminado

El siguiente error se produce cuando intentas crear un entorno de ejecución a partir de la plantilla de entorno de ejecución predeterminada cuando ya existe el entorno de ejecución predeterminado.

Failed to create runtime

One click runtime already exists.

Si intentas crear un entorno de ejecución a partir de una plantilla de entorno de ejecución predeterminada, Colab Enterprise intentará crear un entorno de ejecución predeterminado. Solo puede haber un tiempo de ejecución predeterminado por usuario, proyecto y región. Si ya existe el entorno de ejecución predeterminado, Colab Enterprise no puede crear otro.

Para resolver este problema, conéctate al entorno de ejecución predeterminado existente o crea uno a partir de una plantilla de entorno de ejecución no predeterminada.

No se pudo crear un tiempo de ejecución predeterminado

Cuando Colab Enterprise crea un entorno de ejecución predeterminado, primero crea una plantilla de entorno de ejecución predeterminada que usa para generar el entorno de ejecución predeterminado. Si intentas crear un entorno de ejecución predeterminado sin los permisos necesarios para crear una plantilla de entorno de ejecución, Colab Enterprise no podrá crear el entorno de ejecución predeterminado.

Para resolver este problema, pídele a tu administrador que te otorgue un rol que incluya el permiso aiplatform.notebookRuntimeTemplates.create.

¿Qué sigue?

• Obtén más información sobre los entornos de ejecución y las plantillas de entorno de ejecución.
• Crea una plantilla de entorno de ejecución.
• Para encontrar un notebook que te ayude a comenzar tu proyecto rápidamente, consulta la galería de notebooks.