Crie um tempo de execução

Esta página mostra como criar, iniciar e eliminar um tempo de execução no Colab Enterprise.

Pode criar um tempo de execução para executar código num tempo de execução com uma configuração diferente da predefinição. Os tempos de execução são criados com base num modelo de tempo de execução, que inclui especificações como o tipo de máquina e o tamanho do disco.

Para saber mais acerca dos tempos de execução, consulte o artigo Tempos de execução e modelos de tempo de execução.

Antes de começar

  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.

    Funções necessárias

    Para receber as autorizações de que precisa para criar um tempo de execução no Colab Enterprise, peça ao seu administrador para lhe conceder a função do IAM de administrador do Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

    Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

    Crie um tempo de execução

    Para criar um tempo de execução, pode usar a Google Cloud consola, a Google Cloud CLI ou o Terraform.

    Consola

    Para criar um tempo de execução:

    1. Na Google Cloud consola, aceda à página Ambientes de execução do Colab Enterprise.

      Aceda a Runtimes

    2. No menu Região, selecione a região onde quer a sua execução. Tem de estar na mesma região que o bloco de notas que o usa.

    3. Clique em  Criar.

      É apresentada a caixa de diálogo Criar tempo de execução da Vertex AI.

    4. No menu Modelo de tempo de execução, selecione um modelo de tempo de execução. Se não forem apresentados modelos de tempo de execução, crie um modelo de tempo de execução.

    5. No campo Nome de tempo de execução, introduza um nome para o tempo de execução.

    6. Clique em Criar.

    Por predefinição, quando cria um tempo de execução, tem automaticamente as autorizações necessárias para iniciar e eliminar esse tempo de execução.

    gcloud

    Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

    • DISPLAY_NAME: o nome a apresentar do seu tempo de execução.
    • RUNTIME_TEMPLATE_ID: o ID do modelo de ambiente de execução. O modelo de tempo de execução especifica a configuração de computação do tempo de execução.
    • PROJECT_ID: o ID do seu projeto.
    • REGION: a região onde quer o tempo de execução.

    Execute o seguinte comando:

    Linux, macOS ou 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

    Por predefinição, quando cria um tempo de execução, tem automaticamente as autorizações necessárias para iniciar e eliminar esse tempo de execução.

    Para mais informações sobre o comando para criar um modelo de tempo de execução a partir da linha de comandos, consulte a documentação da CLI gcloud.

    Terraform

    Para saber como aplicar ou remover uma configuração do Terraform, consulte os comandos básicos do Terraform. Para mais informações, consulte a Terraform documentação de referência do fornecedor.

    O exemplo seguinte usa o recurso do Terraform google_colab_runtime para criar um tempo de execução do 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 = "[email protected]"
  description = "Full runtime"

  desired_state = "ACTIVE"

  auto_upgrade = true

  depends_on = [
    google_colab_runtime_template.my_template
  ]
}

    Resolver problemas

    Esta secção mostra como resolver problemas com a criação de tempos de execução no Colab Enterprise.

    Não é possível criar um tempo de execução

    Este problema ocorre quando não consegue criar um tempo de execução. Veja também Não é possível criar um tempo de execução predefinido. As causas mais comuns são:

    Quota insuficiente

    Se não conseguir criar um tempo de execução, pode ter excedido a sua quota de tempo de execução do Compute Engine.

    O Colab Enterprise usa a quota do Compute Engine para os tempos de execução. Para mais informações, consulte a vista geral das quotas e dos limites do Compute Engine.

    Para resolver este problema, peça um ajuste da quota.

    Recursos indisponíveis

    O seguinte erro ocorre quando tenta criar um tempo de execução.

    No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

    Este erro ocorre se não existirem recursos disponíveis para a configuração do tipo de máquina na região do seu bloco de notas.

    Para resolver este problema, experimente qualquer uma das seguintes opções:

    • Crie um tempo de execução numa região diferente.
    • Crie um modelo de tempo de execução com uma configuração de tipo de máquina diferente e, em seguida, crie um tempo de execução com base no novo modelo de tempo de execução.

    O tempo de execução predefinido já existe

    O seguinte erro ocorre quando tenta criar um tempo de execução a partir do modelo de tempo de execução predefinido quando o tempo de execução predefinido já existe. 

    Failed to create runtime

One click runtime already exists.

    Se tentar criar um tempo de execução a partir de um modelo de tempo de execução predefinido, o Colab Enterprise tenta criar um tempo de execução predefinido. Só pode existir um tempo de execução predefinido por utilizador, projeto e região. Se o tempo de execução predefinido já existir, o Colab Enterprise não consegue criar outro tempo de execução predefinido.

    Para resolver este problema, ligue-se ao tempo de execução predefinido existente ou crie um tempo de execução a partir de um modelo de tempo de execução não predefinido.

    Não é possível criar um tempo de execução predefinido

    Quando o Colab Enterprise cria um tempo de execução predefinido, cria primeiro um modelo de tempo de execução predefinido que usa para gerar o tempo de execução predefinido. Se tentar criar um tempo de execução predefinido sem as autorizações necessárias para criar um modelo de tempo de execução, o Colab Enterprise não consegue criar o tempo de execução predefinido.

    Para resolver este problema, peça ao administrador para lhe conceder uma função que inclua a autorização aiplatform.notebookRuntimeTemplates.create.

    O que se segue?