Encerramento de inatividade

Encerramento de inatividade

Os ambientes de execução do Colab Enterprise são desligados após 180 minutos de inatividade por padrão. Nesta página, descrevemos o recurso de encerramento de inatividade e como mudar as configurações padrão ou desativar o recurso ao criar um modelo de ambiente de execução.

Visão geral

Para ajudar a gerenciar custos, os ambientes de execução do Colab Enterprise são desligados após ficarem inativos por um período específico por padrão. É possível mudar esse período ou desativar o recurso ao criar um modelo de ambiente de execução.

Depois de criar um modelo de ambiente de execução, a configuração dele não poderá ser alterada. Portanto, não é possível mudar as configurações de encerramento de inatividade de um ambiente de execução ou modelo de ambiente de execução. Para usar um ambiente de execução com configurações de encerramento de inatividade diferentes, crie um modelo de ambiente de execução com as configurações desejadas e use um ambiente de execução gerado a partir desse modelo.

Antes de começar

Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloud, 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.

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

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.

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

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 modelo de ambiente de execução com configurações específicas de encerramento de inatividade

Para criar um modelo de ambiente de execução com configurações específicas de encerramento de inatividade, você pode usar o Google Cloud console ou a Google Cloud CLI.

Console

Para criar um modelo de ambiente de execução com configurações específicas de encerramento de inatividade:

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

   Acessar "Modelos de ambiente de execução"

2. Clique em  Novo modelo.

   A caixa de diálogo Criar novo modelo de ambiente de execução será exibida.

3. Na seção Fundamentos do ambiente de execução, insira um Nome de exibição.

4. No menu Região, selecione a região em que você quer seu modelo de ambiente de execução.

5. Para mudar as configurações de encerramento de inatividade, clique na seção Configurar computação e conclua a etapa a seguir.

6. Na seção Desativação inativa:

   • Para desativar o encerramento por inatividade, desmarque a opção Ativar encerramento por inatividade.

   • Para alterar o período de inatividade, em Tempo de inatividade antes do encerramento (minutos), altere o número para o número de minutos de inatividade que você quer. No Google Cloud console do, essa configuração pode ser definida como qualquer valor inteiro de 10 a 1440.

7. Na seção Ambiente, selecione um Ambiente. O padrão é Mais recente (atualmente Python 3.12).

8. Opcional: no campo Script de pós-inicialização, insira o URI de um script de pós-inicialização. Para mais informações sobre como usar um script de pós-inicialização, consulte Usar um script de pós-inicialização.

9. Opcional: abaixo do URL do script de pós-inicialização, selecione o comportamento do script de inicialização. O comportamento padrão é Executar uma vez. Para mais informações, consulte Comportamento do script de inicialização-inicialização.

10. Opcional: para adicionar uma variável de ambiente, clique em  Adicionar variável de ambiente, e insira um par de Chave e Valor. Para adicionar mais variáveis de ambiente, repita essa etapa.

11. Clique em Continuar.

12. Preencha o restante da caixa de diálogo de criação.

13. Clique em Criar para concluir a criação do modelo de ambiente de execução.

    Seu modelo de ambiente de execução aparece na lista na guia Modelos de 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 modelo de ambiente de execução.
• INACTIVITY_DURATION: a duração da inatividade antes do encerramento do ambiente de execução. Uma entrada de 0s desativa o recurso de encerramento de inatividade. O intervalo de valores válidos é de 10 minutos (10m) a 24 horas (24h).
• PROJECT_ID: o ID do projeto.
• REGION: a região em que você quer o modelo de 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 runtime-templates create --display-name=DISPLAY_NAME \
    --idle-shutdown-timeout=INACTIVITY_DURATION \
    --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 runtime-templates create --display-name=DISPLAY_NAME `
    --idle-shutdown-timeout=INACTIVITY_DURATION `
    --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 runtime-templates create --display-name=DISPLAY_NAME ^
    --idle-shutdown-timeout=INACTIVITY_DURATION ^
    --project=PROJECT_ID ^
    --region=REGION

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.

Como o encerramento por inatividade funciona

O ambiente de execução é encerrado quando as condições a seguir são atendidas:

• Não há atividade do kernel para o período especificado.

• O ambiente de execução não está conectado a um notebook.

Para desconectar um ambiente de execução de um notebook, feche o notebook. Deixar um notebook aberto enquanto conectado a um ambiente de execução impede que ele seja encerrado.

Para informações sobre cobranças geradas por ambientes de execução, consulte Cobranças de ambiente de execução.

A seguir

• Saiba mais sobre ambientes de execução e modelos de ambiente de execução.
• Saiba como criar um ambiente de execução com base em um modelo de ambiente de execução.
• Para encontrar um notebook que possa ajudar você a iniciar seu projeto rapidamente, consulte a galeria de notebooks.