Crear un entorno de ejecución en Colab Enterprise

En esta página se explica cómo crear, iniciar y eliminar un tiempo de ejecución en Vertex AI.

Puedes crear un tiempo de ejecución para ejecutar código en un tiempo de ejecución que tenga una configuración diferente a la predeterminada. Los tiempos de ejecución se crean a partir de una plantilla de tiempo 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 empezar

  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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

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

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

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

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    8.

    Roles obligatorios

    Para obtener los permisos que necesitas para crear un tiempo de ejecución en Colab Enterprise, pídele a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

    También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

    Crear un tiempo de ejecución

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

    Consola

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

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

      Ir a Tiempos de ejecución

    2. En el menú Región, selecciona la región en la que quieres que se ejecute tu tiempo de ejecución. Debe estar en la misma región que el cuaderno que lo usa.

    3. Haz clic en  Crear.

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

    4. En el menú Plantilla de tiempo de ejecución, selecciona una plantilla de tiempo de ejecución. Si no hay ninguna plantilla de tiempo de ejecución en la lista, crea una.

    5. En el campo Nombre de tiempo de ejecución, introduce un nombre para tu tiempo de ejecución.

    6. Haz clic en Crear.

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

    gcloud

    Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

    • DISPLAY_NAME: el nombre visible de tu tiempo de ejecución.
    • RUNTIME_TEMPLATE_ID: el ID de la plantilla de tiempo de ejecución. La plantilla de tiempo de ejecución especifica la configuración de computación del tiempo de ejecución.
    • PROJECT_ID: tu ID de proyecto.
    • REGION: la región en la que quieres que se ejecute.

    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 tiempo de ejecución, tienes automáticamente los permisos necesarios para iniciarlo y eliminarlo.

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

    Iniciar un tiempo de ejecución

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

    Consola

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

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

      Ir a Tiempos de ejecución

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

    3. Selecciona el tiempo de ejecución que quieras iniciar.

    4. Haz clic en Empezar.

    gcloud

    Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

    • RUNTIME_ID: el ID de tu tiempo de ejecución.
    • PROJECT_ID: tu ID de proyecto.
    • REGION: la región en la que se encuentra tu tiempo 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

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

    Eliminar un tiempo de ejecución

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

    Consola

    Para eliminar un tiempo de ejecución, sigue estos pasos:

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

      Ir a Tiempos de ejecución

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

    3. Selecciona el tiempo de ejecución que quieras eliminar.

    4. Haz clic en  Eliminar.

    5. Haz clic en Confirmar.

    gcloud

    Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

    • RUNTIME_ID: el ID de tu tiempo de ejecución.
    • PROJECT_ID: tu ID de proyecto.
    • REGION: la región en la que se encuentra tu tiempo 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

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

    Solucionar problemas

    En esta sección se explica cómo resolver problemas al crear tiempos de ejecución en Colab Enterprise.

    No se puede crear un tiempo de ejecución

    Este problema se produce cuando no puedes crear un tiempo de ejecución. Consulta también No se puede crear un tiempo de ejecución predeterminado. Las causas más habituales son las siguientes:

    Cuota insuficiente

    Si no puedes crear un tiempo de ejecución, es posible que hayas superado tu cuota de tiempo 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 las cuotas y los límites de Compute Engine.

    Para solucionar este problema, solicita un ajuste de cuota.

    Recursos no disponibles

    Se produce el siguiente error al intentar crear un tiempo 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 en la región de tu cuaderno.

    Para solucionar este problema, prueba una de las siguientes opciones:

    • Crea un tiempo de ejecución en otra región.
    • Crea una plantilla de tiempo de ejecución con una configuración de tipo de máquina diferente y, a continuación, crea un tiempo de ejecución basado en la nueva plantilla.

    El tiempo de ejecución predeterminado ya existe

    Se produce el siguiente error al intentar crear un tiempo de ejecución a partir de la plantilla de tiempo de ejecución predeterminada cuando el tiempo de ejecución predeterminado ya existe. 

    Failed to create runtime

One click runtime already exists.

    Si intentas crear un tiempo de ejecución a partir de una plantilla de tiempo de ejecución predeterminada, Colab Enterprise intentará crear un tiempo de ejecución predeterminado. Solo puede haber un tiempo de ejecución predeterminado por usuario, proyecto y región. Si el entorno de ejecución predeterminado ya existe, Colab Enterprise no podrá crear otro.

    Para solucionar este problema, conéctate al tiempo de ejecución predeterminado o crea un tiempo de ejecución a partir de una plantilla de tiempo de ejecución no predeterminada.

    No se puede crear un tiempo de ejecución predeterminado

    Cuando Colab Enterprise crea un tiempo de ejecución predeterminado, primero crea una plantilla de tiempo de ejecución predeterminada que usa para generar el tiempo 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 solucionar este problema, pide a tu administrador que te asigne un rol que incluya el permiso aiplatform.notebookRuntimeTemplates.create.

    Siguientes pasos