Criar um ambiente de execução

Nesta página, mostramos como criar, iniciar e excluir um ambiente de execução no Colab Enterprise.

É possível criar um ambiente de execução para executar código em um ambiente de execução que tenha uma configuração diferente do padrão. Os tempos de execução são criados com base em um modelo de ambiente de execução, que inclui especificações como tipo de máquina e tamanho do disco.

Para saber mais sobre ambientes de execução, consulte Ambientes de execução e modelos de ambiente de execução.

Antes de começar

Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.

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

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.

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

Funções exigidas

Para receber as permissões necessárias para criar um ambiente de execução no Colab Enterprise, peça ao administrador para conceder a você o papel do IAM de Administrador do Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Um ou mais dos papéis necessários incluem a permissão dataform.repositories.list. Os usuários que recebem a permissão dataform.repositories.list ou o papel de criador de código (roles/dataform.codeCreator) em um projeto podem listar os nomes dos recursos de código nesse projeto usando a API Dataform ou a interface de linha de comando (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver os recursos de código que criaram ou que foram compartilhados com eles.

Criar um ambiente de execução

Para criar um ambiente de execução, use o Google Cloud console, a Google Cloud CLI ou o Terraform.

Console

Para criar um ambiente de execução:

No Google Cloud console do, acesse a página Ambientes de execução do Colab Enterprise.

Acessar ambientes de execução
No menu Região, selecione a região em que você quer o ambiente de execução. Ele precisa estar na mesma região do notebook que utiliza.
Clique em Criar.

A caixa de diálogo Criar ambiente de execução da Vertex AI será exibida.
No menu Modelo de execução, selecione um modelo de ambiente de execução. Se não houver modelos de ambiente de execução listados, crie um modelo de ambiente de execução.
No campo Nome do ambiente de execução, insira um nome para o ambiente de execução.
Clique em Criar.

Por padrão, ao criar um ambiente de execução, você recebe automaticamente as permissões necessárias para iniciar e excluir esse ambiente de execução.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

DISPLAY_NAME: o nome de exibição do ambiente de execução.
RUNTIME_TEMPLATE_ID: o ID do modelo de ambiente de execução. O modelo de ambiente de execução especifica a configuração de computação do ambiente de execução.
PROJECT_ID: o ID do projeto.
REGION: a região em que você quer o ambiente 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 padrão, ao criar um ambiente de execução, você recebe automaticamente as permissões necessárias para iniciar e excluir esse ambiente de execução.

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

Terraform

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

O exemplo a seguir usa o google_colab_runtime recurso do Terraform para criar um ambiente de execução do Colab Enterprise runtime.

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 = "gterraformtestuser@gmail.com"
  description = "Full runtime"

  desired_state = "ACTIVE"

  auto_upgrade = true

  depends_on = [
    google_colab_runtime_template.my_template
  ]
}

Resolver problemas

Nesta seção, mostramos como resolver problemas com a criação de ambientes de execução no Colab Enterprise.

Não foi possível criar um ambiente de execução

Esse problema ocorre quando não é possível criar um ambiente de execução. Consulte também Não foi possível criar um ambiente de execução padrão . As causas mais comuns são:

Cota insuficiente

Se não for possível criar um ambiente de execução, talvez você tenha excedido a cota de tempo de execução do Compute Engine.

O Colab Enterprise usa a cota do Compute Engine para ambientes de execução. Para mais informações, consulte a visão geral de cotas e limites do Compute Engine.

Para resolver esse problema, solicite um ajuste de cota.

Recursos indisponíveis

O seguinte erro ocorre quando você 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.

Esse erro ocorrerá se não houver recursos disponíveis para a configuração do tipo de máquina na região do seu notebook.

Para resolver esse problema, tente uma das seguintes opções:

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

O ambiente de execução padrão já existe

O erro a seguir ocorre quando você tenta criar um ambiente de execução com base no modelo de ambiente de execução padrão quando ele já existe.

Failed to create runtime

One click runtime already exists.

Se você tentar criar um ambiente de execução com base em um modelo de ambiente de execução padrão, o Colab Enterprise vai tentar criar um ambiente de execução padrão. Só pode haver um ambiente de execução padrão por usuário, projeto e região. Se o ambiente de execução padrão já existir, o Colab Enterprise não poderá criar outro.

Para resolver esse problema, conecte-se ao ambiente de execução padrão existente ou crie um ambiente de execução com base em um modelo de ambiente de execução não padrão.

Não foi possível criar um ambiente de execução padrão

Quando o Colab Enterprise cria um ambiente de execução padrão, ele primeiro cria um modelo de ambiente de execução padrão que é usado para gerar o ambiente de execução padrão. Se você tentar criar um ambiente de execução padrão sem as permissões necessárias para criar um modelo de ambiente de execução, então o Colab Enterprise não poderá criar o ambiente de execução padrão.

Para resolver esse problema, peça ao administrador para conceder a você um papel que inclua a aiplatform.notebookRuntimeTemplates.create permissão.

A seguir

Para gerenciar o ambiente de execução, consulte Gerenciar ambientes de execução.
Saiba mais sobre ambientes de execução e modelos de ambiente de execução.
Conecte-se ao ambiente de execução.
Saiba como criar um modelo de ambiente de execução.