Encerramento por inatividade

Encerramento por inatividade

Os tempos de execução do Colab Enterprise são encerrados após 180 minutos de inatividade por predefinição. Esta página descreve a funcionalidade de encerramento por inatividade e como alterar as predefinições de encerramento por inatividade ou desativar a funcionalidade quando cria um modelo de tempo de execução.

Vista geral

Para ajudar a gerir os custos, os tempos de execução do Colab Enterprise são encerrados por predefinição após ficarem inativos durante um período específico. Pode alterar o período ou desativar esta funcionalidade quando cria um modelo de tempo de execução.

Depois de criar um modelo de tempo de execução, não é possível alterar a respetiva configuração. Por conseguinte, não pode alterar as definições de encerramento por inatividade de um tempo de execução ou de um modelo de tempo de execução. Para usar um tempo de execução com definições de encerramento por inatividade diferentes, tem de criar um modelo de tempo de execução com as definições pretendidas e, em seguida, usar um tempo de execução gerado a partir desse modelo de tempo de execução.

Antes de começar

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.

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.

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

Uma ou mais das funções necessárias incluem a autorização dataform.repositories.list. Os utilizadores aos quais é concedida a autorização dataform.repositories.list ou a função Criador de código (roles/dataform.codeCreator) num projeto podem listar os nomes dos recursos de código nesse projeto através da API Dataform ou da interface de linha de comandos (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver recursos de código que criaram ou que foram partilhados com eles.

Crie um modelo de tempo de execução com definições de encerramento por inatividade específicas

Para criar um modelo de tempo de execução com definições de encerramento por inatividade específicas, pode usar a Google Cloud consola ou a CLI Google Cloud.

Consola

Para criar um modelo de tempo de execução com definições de encerramento por inatividade específicas:

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

   Aceda aos modelos dos ambientes de execução

2. Clique em  Novo modelo.

   É apresentada a caixa de diálogo Criar novo modelo de tempo de execução.

3. Na secção Noções básicas de tempo de execução, introduza um Nome a apresentar.

4. No menu Região, selecione a região onde quer o modelo de tempo de execução.

5. Para alterar as definições de encerramento por inatividade, clique na secção Configurar computação e conclua o passo seguinte.

6. Na secção Desligamento por inatividade:

   • 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 pretende. Na Google Cloud consola, esta definição pode ser definida para qualquer valor inteiro de 10 a 1440.

7. Na secção Ambiente, selecione um Ambiente. A predefinição é Mais recente (atualmente, Python 3.11).

8. Clique em Continuar.

9. Conclua o resto da caixa de diálogo de criação.

10. Clique em Criar para concluir a criação do modelo de tempo de execução.

    O modelo de tempo de execução é apresentado na lista no separador Modelos de 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 modelo de tempo de execução.
• INACTIVITY_DURATION: a duração da inatividade antes de o tempo de execução ser encerrado. Uma entrada de 0s desativa a funcionalidade de encerramento por inatividade. O intervalo de valores válidos é de 10 minutos (10m) a 24 horas (24h).
• PROJECT_ID: o ID do seu projeto.
• REGION: a região onde quer o modelo de tempo de execução.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Nota: Certifique-se de que inicializou a CLI Google Cloud com autenticação e um projeto executando 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)

Nota: Certifique-se de que inicializou a CLI Google Cloud com autenticação e um projeto executando 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)

Nota: Certifique-se de que inicializou a CLI Google Cloud com autenticação e um projeto executando 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 tempo de execução a partir da linha de comandos, consulte a documentação da CLI gcloud.

Como funciona o encerramento por inatividade

O tempo de execução é encerrado quando as seguintes condições são cumpridas:

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

• O tempo de execução não está associado a um bloco de notas.

Para desassociar um tempo de execução de um bloco de notas, feche o bloco de notas. Deixar um bloco de notas aberto enquanto está ligado a um tempo de execução impede que o tempo de execução seja encerrado.

Para obter informações sobre as cobranças geradas pelos tempos de execução, consulte o artigo Cobranças de tempo de execução.

O que se segue?

• Saiba mais acerca dos tempos de execução e dos modelos de tempo de execução.
• Saiba como criar um tempo de execução com base num modelo de tempo de execução.
• Para encontrar um bloco de notas que possa ajudar a iniciar o seu projeto rapidamente, consulte a galeria de blocos de notas.