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

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. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Ir al selector de proyectos

3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

4. Habilita las API de Vertex AI, Dataform, and Compute Engine.

   Habilita las API

5. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Ir al selector de proyectos

6. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

7. Habilita las API de Vertex AI, Dataform, and Compute Engine.

   Habilita las API

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 necesarios

A fin de 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 a tu cuenta de usuario el rol de IAM de usuario empresarial Colab (roles/aiplatform.colabEnterpriseUser) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

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.

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.

   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 necesarios

A fin de 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 a tu cuenta de usuario el rol de IAM de usuario empresarial Colab (roles/aiplatform.colabEnterpriseUser) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

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.

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

A fin de garantizar 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 a tu cuenta de usuario la función de administrador de Colab Enterprise IAM(roles/aiplatform.colabEnterpriseAdmin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

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.

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

Solución de 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 usa Colab Enterprise 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.go888ogle.com.fqhub.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.go888ogle.com.fqhub.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.