Crea un entorno de ejecución en Colab Enterprise

En esta página, se muestra cómo crear, iniciar y borrar un entorno de ejecución en Vertex AI.

Puedes crear un entorno de ejecución para ejecutar código en un entorno de ejecución que tenga una configuración diferente a la predeterminada. Los entornos de ejecución se crean en función de una plantilla de entorno de ejecución, que incluye especificaciones como el tipo de máquina y el tamaño del disco.

Para obtener más información sobre los entornos de ejecución, consulta Entornos de ejecución y plantillas de entorno de ejecución.

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.

   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.

   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

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.

Crea un entorno de ejecución

Para crear un entorno de ejecución, puedes usar la consola de Google Cloud o Google Cloud CLI.

gcloud colab runtimes create --display-name="DISPLAY_NAME" \
    --runtime-template=RUNTIME_TEMPLATE_ID \
    --project=PROJECT_ID \
    --region=REGION

gcloud colab runtimes create --display-name="DISPLAY_NAME" `
    --runtime-template=RUNTIME_TEMPLATE_ID `
    --project=PROJECT_ID `
    --region=REGION

gcloud colab runtimes create --display-name="DISPLAY_NAME" ^
    --runtime-template=RUNTIME_TEMPLATE_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Cómo iniciar un entorno de ejecución

Para iniciar un entorno de ejecución, puedes usar la consola de Google Cloud o gcloud CLI.

gcloud colab runtimes start RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

gcloud colab runtimes start RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

gcloud colab runtimes start RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Cómo borrar un entorno de ejecución

Para borrar un entorno de ejecución, puedes usar la consola de Google Cloud o gcloud CLI.

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Solucionar problemas

En esta sección, se muestra cómo resolver problemas con la creación de entornos de ejecución en Colab Enterprise.

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:

Cuota insuficiente

Si no puedes crear un entorno de ejecución, es posible que hayas excedido tu cuota de entorno de ejecución de Compute Engine.

Colab Enterprise usa la cuota de Compute Engine para los entornos de ejecución. Para obtener más información, consulta la descripción general de los límites y cuota de Compute Engine.

Para resolver este problema, solicita un límite de cuota más alto.

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 un entorno de ejecución con una configuración de tipo de máquina diferente o vuelve a intentarlo más tarde.

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 predeterminado cuando este ya existe.

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 predeterminado, Colab Enterprise intentará crear un entorno de ejecución predeterminado. Solo puede haber un entorno de ejecución predeterminado por usuario, proyecto y región. Si el entorno de ejecución predeterminado ya existe, 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 predeterminado.

No se pudo crear un entorno 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 generarlo. 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á crearlo.

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.
• Conéctate a tu entorno de ejecución.
• Obtén más información para crear una plantilla de entorno de ejecución.