Crear una plantilla de tiempo de ejecución

En esta página se explica cómo crear una plantilla de tiempo de ejecución en Colab Enterprise.

Para ejecutar código en tu cuaderno, debes usar un recurso de computación llamado tiempo de ejecución. Puedes usar el tiempo de ejecución predeterminado o uno creado a partir de una plantilla de tiempo de ejecución. Si creas una plantilla de tiempo de ejecución, puedes configurarla para optimizar el rendimiento, el coste y otras características de un tiempo de ejecución en función de tus necesidades.

Consulta más información sobre los runtimes y las plantillas de runtime.

Antes de empezar

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.

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

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

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 una plantilla de tiempo de ejecución en Colab Enterprise, pide 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 la plantilla de tiempo de ejecución

Para crear una plantilla de tiempo de ejecución, puedes usar la Google Cloud consola, la CLI de Google Cloud, la API REST o Terraform.

Consola

Para crear una plantilla de tiempo de ejecución, siga estos pasos:

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

   Ir a Plantillas de entorno de ejecución

2. Haz clic en add_box Nueva plantilla.

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

Conceptos básicos del tiempo de ejecución

1. En la sección Aspectos básicos del tiempo de ejecución, introduce un Nombre visible.

2. En el menú Región, selecciona la región en la que quieres que esté tu plantilla de tiempo de ejecución.

3. Opcional: Añada una Descripción de su plantilla de tiempo de ejecución.

4. Opcional: Para añadir una etiqueta, haz clic en add Añadir etiqueta y, a continuación, introduce un par de Clave y Valor. Para añadir más etiquetas, repite este paso.

5. Haz clic en Continuar.

Configurar los recursos de computación

1. En la sección Configurar recursos de computación, vaya al menú Tipo de máquina y seleccione un tipo de máquina. Para obtener información sobre los tipos de máquinas, consulta el recurso y la guía de comparación de familias de máquinas.

   Si seleccionas un tipo de máquina que tenga GPUs, elige el tipo de acelerador y el número de aceleradores. Si no puedes seleccionar el número de GPUs que quieres, es posible que tengas que aumentar tu cuota. Consulta Solicitar un ajuste de cuota.

2. En el menú Tipo de disco de datos, selecciona un tipo de disco.

3. En el campo Tamaño del disco de datos, introduzca un tamaño en GB.

4. En la sección Apagado por inactividad:

   • Para desactivar el cierre por inactividad, desmarca la opción Habilitar cierre por inactividad.

   • Para cambiar el periodo de inactividad, en Tiempo de inactividad antes del apagado (minutos), cambia el número por el número de minutos de inactividad que quieras. En la consola Google Cloud , este ajuste puede tener cualquier valor entero entre 10 y 1440.

5. Haz clic en Continuar.

Entorno

1. En la sección Entorno, selecciona un Entorno. El valor predeterminado es Más reciente (actualmente Python 3.11).

2. Haz clic en Continuar.

Redes y seguridad

1. En la sección Redes y seguridad, en el menú Red, selecciona una red. Si no seleccionas ninguna red, se elegirá la predeterminada.

2. En el menú Subred, seleccione una subred.

3. Para desactivar el acceso público a Internet, desmarca la opción Habilitar acceso público a Internet.

4. Para desactivar el acceso con credenciales de usuario final, desmarca Habilitar credenciales de usuario final.

Terminar de crear la plantilla de tiempo de ejecución

Haga clic en Crear para terminar de crear la plantilla de tiempo de ejecución.

La plantilla de tiempo de ejecución aparecerá en la lista de la pestaña Plantillas de tiempo de ejecución.

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 plantilla de tiempo de ejecución.
• PROJECT_ID: tu ID de proyecto.
• REGION: la región en la que quieras que esté tu plantilla de tiempo de ejecución.
• MACHINE_TYPE: el tipo de máquina que se va a usar en tu tiempo de ejecución.
• ACCELERATOR_TYPE: el tipo de acelerador de hardware que se va a usar en tu tiempo de ejecución.
• ACCELERATOR_COUNT: número de aceleradores que se van a usar en tu tiempo de ejecución.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud colab runtime-templates create --display-name="DISPLAY_NAME" \
    --project=PROJECT_ID \
    --region=REGION \
    --machine-type=MACHINE_TYPE \
    --accelerator-type=ACCELERATOR_TYPE \
    --accelerator-count=ACCELERATOR_COUNT

Windows (PowerShell)

gcloud colab runtime-templates create --display-name="DISPLAY_NAME" `
    --project=PROJECT_ID `
    --region=REGION `
    --machine-type=MACHINE_TYPE `
    --accelerator-type=ACCELERATOR_TYPE `
    --accelerator-count=ACCELERATOR_COUNT

Windows (cmd.exe)

gcloud colab runtime-templates create --display-name="DISPLAY_NAME" ^
    --project=PROJECT_ID ^
    --region=REGION ^
    --machine-type=MACHINE_TYPE ^
    --accelerator-type=ACCELERATOR_TYPE ^
    --accelerator-count=ACCELERATOR_COUNT

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.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• REGION: la región en la que quieras que esté tu plantilla de tiempo de ejecución.
• PROJECT_ID: tu ID de proyecto.
• DISPLAY_NAME: el nombre visible de tu plantilla de tiempo de ejecución.
• MACHINE_TYPE: el tipo de máquina que se va a usar en tu tiempo de ejecución.
• ACCELERATOR_TYPE: el tipo de acelerador de hardware que se va a usar en tu tiempo de ejecución.
• ACCELERATOR_COUNT: número de aceleradores que se van a usar en tu tiempo de ejecución.

Método HTTP y URL:

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates

Cuerpo JSON de la solicitud:

{
  "displayName": "DISPLAY_NAME",
  "machineSpec": {
    {
      "machineType": MACHINE_TYPE
      "acceleratorType": ACCELERATOR_TYPE,
      "acceleratorCount": ACCELERATOR_COUNT,
    }
  },
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates" | Select-Object -Expand Content

Si la solicitud se completa correctamente, en el cuerpo de la respuesta se incluye una instancia de Operation.

Para obtener más información, consulta la documentación de la API REST notebookRuntimeTemplates.create.

Terraform

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform. Para obtener más información, consulta la documentación de referencia del proveedor Terraform.

En el siguiente ejemplo se usa el recurso de Terraform google_colab_runtime_template para crear una plantilla de entorno de ejecución de Colab Enterprise.

resource "google_compute_network" "my_network" {
  name = "{{index $.Vars "network_name"}}"
  auto_create_subnetworks = false
}

resource "google_compute_subnetwork" "my_subnetwork" {
  name   = "{{index $.Vars "network_name"}}"
  network = google_compute_network.my_network.id
  region = "us-central1"
  ip_cidr_range = "10.0.1.0/24"
}

resource "google_colab_runtime_template" "{{$.PrimaryResourceId}}" {
  name        = "{{index $.Vars "runtime_template_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
    network = google_compute_network.my_network.id
    subnetwork = google_compute_subnetwork.my_subnetwork.id
  }

  labels = {
    k = "val"
  }

  idle_shutdown_config {
    idle_timeout = "3600s"
  }

  euc_config {
    euc_disabled = false
  }

  shielded_vm_config {
    enable_secure_boot = false
  }

  network_tags = ["abc", "def"]

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

Conceder acceso a la plantilla de tiempo de ejecución

Después de crear una plantilla de tiempo de ejecución, debes conceder acceso a ella para que una cuenta principal pueda usarla. Un director puede crear un tiempo de ejecución a partir de una plantilla de tiempo de ejecución solo si tiene lo siguiente:

• Acceso a la plantilla de tiempo de ejecución.
• Los permisos necesarios para crear tiempos de ejecución.

Consulta Gestionar el acceso a una plantilla de tiempo de ejecución.

Eliminar una plantilla de tiempo de ejecución

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

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

   Ir a Plantillas de entorno de ejecución

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

3. Selecciona la plantilla de tiempo de ejecución que quieras eliminar.

4. Haz clic en delete Eliminar.

5. Haz clic en Confirmar.

Solucionar problemas

En esta sección se explica cómo solucionar problemas al crear plantillas de tiempo de ejecución en Colab Enterprise.

No se pueden seleccionar suficientes GPUs

Cuando creas una plantilla de entorno de ejecución, no puedes seleccionar el número de GPUs que quieres. Esto puede deberse a que no tienes suficiente cuota.

Colab Enterprise usa la cuota de Compute Engine para las GPUs. 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.

Siguientes pasos

• Consulta más información sobre los runtimes y las plantillas de runtime.
• Consulta cómo crear un tiempo de ejecución a partir de una plantilla de tiempo de ejecución.