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.

  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

    8.

    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

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

    Console

    Para crear un entorno de ejecución, sigue estos pasos:

    1. En la consola de Google Cloud , ve a la página Entornos de ejecución de Colab Enterprise.

      Ir a Entornos de ejecución

    2. En el menú Región, selecciona la región en la que deseas que se ejecute el entorno de ejecución. Debe estar en la misma región que el notebook que lo usa.

    3. Haz clic en  Crear.

      Aparecerá el cuadro de diálogo Crear entorno de ejecución de Vertex AI.

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

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

    6. Haz clic en Crear.

    De forma predeterminada, cuando creas un entorno de ejecución, tienes automáticamente los permisos necesarios para iniciarlo y borrarlo.

    gcloud

    Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

    • DISPLAY_NAME: Es el nombre visible de tu entorno de ejecución.
    • RUNTIME_TEMPLATE_ID: El ID de la plantilla del entorno de ejecución. La plantilla del entorno de ejecución especifica la configuración de procesamiento de tu entorno de ejecución.
    • PROJECT_ID: el ID de tu proyecto
    • REGION: Es la región en la que deseas que se encuentre tu entorno de ejecución.

    Ejecuta el siguiente comando:

    Linux, macOS o Cloud Shell

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

    Windows (PowerShell)

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

    Windows (cmd.exe)

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

    De forma predeterminada, cuando creas un entorno de ejecución, tienes automáticamente los permisos necesarios para iniciarlo y borrarlo.

    Si deseas obtener más información sobre el comando para crear una plantilla de entorno de ejecución desde la línea de comandos, consulta la documentación de gcloud CLI.

    Cómo iniciar un entorno de ejecución

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

    Console

    Para iniciar un entorno de ejecución, sigue estos pasos:

    1. En la consola de Google Cloud , ve a la página Entornos de ejecución de Colab Enterprise.

      Ir a Entornos de ejecución

    2. En el menú Región, selecciona la región que contiene el entorno de ejecución.

    3. Selecciona el entorno de ejecución que deseas iniciar.

    4. Haz clic en Iniciar.

    gcloud

    Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

    • RUNTIME_ID: Es el ID de tu entorno de ejecución.
    • PROJECT_ID: el ID de tu proyecto
    • REGION: Es la región en la que se encuentra tu entorno de ejecución.

    Ejecuta el siguiente comando:

    Linux, macOS o Cloud Shell

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

    Windows (PowerShell)

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

    Windows (cmd.exe)

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

    Si deseas obtener más información sobre el comando para crear una plantilla de entorno de ejecución desde la línea de comandos, consulta la documentación de gcloud CLI.

    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.

    Console

    Para borrar un entorno de ejecución, sigue estos pasos:

    1. En la consola de Google Cloud , ve a la página Entornos de ejecución de Colab Enterprise.

      Ir a Entornos de ejecución

    2. En el menú Región, selecciona la región que contiene el entorno de ejecución.

    3. Selecciona el entorno de ejecución que quieres borrar.

    4. Haz clic en Borrar.

    5. Haz clic en Confirmar.

    gcloud

    Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

    • RUNTIME_ID: Es el ID de tu entorno de ejecución.
    • PROJECT_ID: el ID de tu proyecto
    • REGION: Es la región en la que se encuentra tu entorno de ejecución.

    Ejecuta el siguiente comando:

    Linux, macOS o Cloud Shell

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

    Windows (PowerShell)

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

    Windows (cmd.exe)

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

    Si deseas obtener más información sobre el comando para crear una plantilla de entorno de ejecución desde la línea de comandos, consulta la documentación de gcloud CLI.

    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 ajuste de cuota.

    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 entorno de ejecución en una región diferente.
    • 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 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 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á crearlo.

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

    ¿Qué sigue?