Crea un entorno de ejecución en Colab Enterprise

En esta página, se muestra cómo crear, iniciar y borrar un tiempo 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 tiempos de ejecución, consulta Tiempos de ejecución y plantillas de tiempo 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

  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 tiempo 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, automáticamente tienes 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: Es el ID de la plantilla de entorno de ejecución. La plantilla de entorno de ejecución especifica la configuración de procesamiento del 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, automáticamente tienes los permisos necesarios para iniciarlo y borrarlo.

    Si deseas obtener más información sobre el comando para crear una plantilla 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 tiempo de ejecución, puedes usar la consola de Google Cloud o gcloud CLI.

    Console

    Para iniciar un entorno de ejecución, haz lo siguiente:

    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 tu entorno de ejecución.

    3. Selecciona el tiempo 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 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 tiempo de ejecución, puedes usar la Google Cloud consola o gcloud CLI.

    Console

    Para borrar un tiempo de ejecución, haz lo siguiente:

    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 tu entorno de ejecución.

    3. Selecciona el tiempo de ejecución que deseas 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 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 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?