Crea un entorno de ejecución

Crea un entorno de ejecución

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

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

Accede a tu Google Cloud cuenta de. 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.

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

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 a través de roles personalizados o cualquier otro rol predefinido.

Uno o más de los roles necesarios incluyen el permiso dataform.repositories.list. Los usuarios a los que se les otorgó el permiso dataform.repositories.list o el rol Creador de código (roles/dataform.codeCreator) en un proyecto pueden enumerar los nombres de los elementos de código de ese proyecto mediante la API de Dataform o la interfaz de línea de comandos (CLI) de Dataform. Los usuarios que no son administradores que usan BigQuery Studio solo pueden ver los elementos de código que crearon o que se compartieron con ellos.

Crea un entorno de ejecución

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

Console

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

1. En la Google Cloud consola de, 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 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 iniciar y borrar ese entorno de ejecución.

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 de tu entorno de ejecución.
• PROJECT_ID: Es 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

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

Windows (PowerShell)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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 iniciar y borrar ese entorno de ejecución.

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.

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform. Para obtener más información, consulta la Terraform documentación de referencia del proveedor.

En el siguiente ejemplo, se usa el google_colab_runtime recurso de Terraform para crear un entorno de ejecución de Colab Enterprise

resource "google_colab_runtime_template" "my_template" {
  name        = "{{index $.Vars "runtime_name"}}"
  display_name = "Runtime template full"
  location    = "us-central1"
  description = "Full runtime template"
  machine_spec {
    machine_type     = "n1-standard-2"
    accelerator_type = "NVIDIA_TESLA_T4"
    accelerator_count = "1"
  }

  data_persistent_disk_spec {
    disk_type    = "pd-standard"
    disk_size_gb = 200
  }

  network_spec {
    enable_internet_access = true
  }

  labels = {
    k = "val"
  }

  idle_shutdown_config {
    idle_timeout = "3600s"
  }

  euc_config {
    euc_disabled = true
  }

  shielded_vm_config {
    enable_secure_boot = true
  }

  network_tags = ["abc", "def"]

  encryption_spec {
    kms_key_name = "{{index $.Vars "key_name"}}"
  }
}

resource "google_colab_runtime" "{{$.PrimaryResourceId}}" {
  name = "{{index $.Vars "runtime_name"}}"
  location = "us-central1" 

  notebook_runtime_template_ref {
    notebook_runtime_template = google_colab_runtime_template.my_template.id
  }

  display_name = "Runtime full"
  runtime_user = "[e-mail]"
  description = "Full runtime"

  desired_state = "ACTIVE"

  auto_upgrade = true

  depends_on = [
    google_colab_runtime_template.my_template
  ]
}

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

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

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

No se puede 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, entonces Colab Enterprise no puede crear el entorno de ejecución predeterminado.

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

¿Qué sigue?

• Para administrar tu entorno de ejecución, consulta Administra entornos de ejecución.
• 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.