Criar um ambiente de execução no Colab Enterprise

Nesta página, mostramos como criar, iniciar e excluir um ambiente de execução na Vertex AI.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

Funções exigidas

Para garantir que sua conta de usuário tenha as permissões necessárias para criar um ambiente de execução no Colab Enterprise, peça para seu administrador conceder à sua conta de usuário o papel de Administrador do Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) do IAM no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

O administrador também pode conceder à sua conta de usuário as permissões necessárias via funções personalizadas ou outros papéis predefinidos.

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 console do Google Cloud ou a Google Cloud CLI.

Console

Para criar um ambiente de execução:

1. No Console do 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 ambiente de execução.

   A caixa de diálogo Criar ambiente de execução da Vertex AI será exibida.

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, quando você cria um ambiente de execução, recebe automaticamente as permissões necessárias para iniciá-lo e excluí-lo.

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 execução. O modelo 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

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud colab runtimes create --display-name="DISPLAY_NAME" \
    --runtime-template=RUNTIME_TEMPLATE_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud colab runtimes create --display-name="DISPLAY_NAME" `
    --runtime-template=RUNTIME_TEMPLATE_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud colab runtimes create --display-name="DISPLAY_NAME" ^
    --runtime-template=RUNTIME_TEMPLATE_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Por padrão, quando você cria um ambiente de execução, recebe automaticamente as permissões necessárias para iniciá-lo e excluí-lo.

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

Iniciar um ambiente de execução

Para iniciar um ambiente de execução, use o console do Google Cloud ou a CLI gcloud.

Console

Para iniciar um ambiente de execução:

1. No Console do 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 que contém o ambiente de execução.

3. Selecione o ambiente de execução que você quer iniciar.

4. Clique em Iniciar.

gcloud

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

• RUNTIME_ID: o ID do ambiente de execução.
• PROJECT_ID: o ID do projeto.
• REGION: a região em que o ambiente de execução está localizado.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud colab runtimes start RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud colab runtimes start RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud colab runtimes start RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

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

Excluir um ambiente de execução

Para excluir um ambiente de execução, use o console do Google Cloud ou a CLI gcloud.

Console

Para excluir um ambiente de execução:

1. No Console do 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 que contém o ambiente de execução.

3. Selecione o ambiente de execução que você quer excluir.

4. Clique em  Excluir.

5. Clique em Confirmar.

gcloud

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

• RUNTIME_ID: o ID do ambiente de execução.
• PROJECT_ID: o ID do projeto.
• REGION: a região em que o ambiente de execução está localizado.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

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

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 é 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 limite de cota maior.

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, teste um ambiente de execução com uma configuração de tipo de máquina diferente ou tente novamente mais tarde.

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

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

Failed to create runtime

One click runtime already exists.

Se você tentar criar um ambiente de execução usando um modelo 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 vai conseguir criar outro ambiente de execução padrão.

Para resolver esse problema, conecte-se ao ambiente de execução padrão atual ou crie um ambiente de execução usando 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, 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 permissão aiplatform.notebookRuntimeTemplates.create.

A seguir

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