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

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

  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 role (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 Agent Platform, 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 role (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 Agent Platform, 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 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.

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

  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 del 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 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 {