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

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

  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.

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 papéis personalizados ou outros papéis predefinidos.

Criar um ambiente de execução

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

Console

Para criar um ambiente de execução:

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

    Acessar ambientes de execução

  2. 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 o utiliza.

  3. Clique em  Criar.

    A caixa de diálogo Criar ambiente de execução da Agent Platform vai aparecer.

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

  5. No campo Nome do ambiente de execução, insira um nome para o ambiente de execução.

  6. Clique em Criar.

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

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ê tem automaticamente as permissões necessárias para iniciar e excluir esse ambiente.

Para mais informações sobre o comando para criar um modelo de tempo de execução usando a 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 documentação de referência do provedor Terraform.

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