Conéctate a un entorno de ejecución en Colab Enterprise

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

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

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

   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

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

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

   Enable the APIs

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

   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

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

7. 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 asegurarte de que tu cuenta de usuario tenga los permisos necesarios para conectarse al entorno de ejecución predeterminado en un notebook de Colab Enterprise, pídele a tu administrador que le 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.

Es posible que tu administrador también pueda otorgar a tu cuenta de usuario los permisos necesarios a través de roles personalizados o de otros roles predefinidos.

Uno o más de los roles necesarios incluyen el permiso dataform.repositories.list. Los usuarios a los que se les otorgó el permiso dataform.repositories.list o el rol Creador de código (roles/dataform.codeCreator) en un proyecto pueden enumerar los nombres de los elementos de código de ese proyecto mediante la API de Dataform o la interfaz de línea de comandos (CLI) de Dataform. Los usuarios que no son administradores que usan BigQuery Studio solo pueden ver los elementos de código que crearon o que se compartieron con ellos.

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 Notebooks de Colab Enterprise.

   Ir a Notebooks

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

3. En la pestaña Mis notebooks, haz clic en el notebook que deseas 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.

   El entorno de ejecución predeterminado tiene credenciales de usuario final habilitadas de forma predeterminada. Para usar un entorno de ejecución que no tenga acceso a tus credenciales de usuario, crea una plantilla de entorno de ejecución sin credenciales de usuario final habilitadas.

   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 asegurarte de que tu cuenta de usuario tenga los permisos necesarios para conectarse a un entorno de ejecución existente en un notebook de Colab Enterprise, pídele a tu administrador que le 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.

Es posible que tu administrador también pueda otorgar a tu cuenta de usuario los permisos necesarios a través de roles personalizados o de otros roles predefinidos.

Uno o más de los roles necesarios incluyen el permiso dataform.repositories.list. Los usuarios a los que se les otorgó el permiso dataform.repositories.list o el rol Creador de código (roles/dataform.codeCreator) en un proyecto pueden enumerar los nombres de los elementos de código de ese proyecto mediante la API de Dataform o la interfaz de línea de comandos (CLI) de Dataform. Los usuarios que no son administradores que usan BigQuery Studio solo pueden ver los elementos de código que crearon o que se compartieron con ellos.

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 Notebooks de Colab Enterprise.

   Ir a Notebooks

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

3. En la pestaña Mis notebooks, haz clic en el notebook que deseas 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 usar un entorno de ejecución que no tenga acceso a tus credenciales de usuario, crea una plantilla de entorno de ejecución sin las credenciales de usuario final habilitadas.

   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 asegurarte de que tu cuenta de usuario tenga los permisos necesarios para crear un entorno de ejecución en Colab Enterprise, pídele a tu administrador que le otorgue el rol de 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.

Es posible que tu administrador también pueda otorgar a tu cuenta de usuario los permisos necesarios a través de roles personalizados o de otros roles predefinidos.

Uno o más de los roles necesarios incluyen el permiso dataform.repositories.list. Los usuarios a los que se les otorgó el permiso dataform.repositories.list o el rol Creador de código (roles/dataform.codeCreator) en un proyecto pueden enumerar los nombres de los elementos de código de ese proyecto mediante la API de Dataform o la interfaz de línea de comandos (CLI) de Dataform. Los usuarios que no son administradores que usan BigQuery Studio solo pueden ver los elementos de código que crearon o que se compartieron con ellos.

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 Notebooks de Colab Enterprise.

   Ir a Notebooks

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

3. En la pestaña Mis notebooks, haz clic en el notebook que deseas 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 usar un entorno de ejecución que no tenga acceso a tus credenciales de usuario, crea una plantilla de entorno de ejecución sin las credenciales de usuario final habilitadas.

   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.

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

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