Gerenciar ambientes de execução

Nesta página, descrevemos como gerenciar um ambiente de execução do Colab Enterprise, incluindo as seguintes tarefas:

  • Inicie um ambiente de execução.
  • Desconecte-se de um ambiente de execução.
  • Reconecte-se a um ambiente de execução.
  • Mude o ambiente de execução ao qual você está conectado.
  • Excluir um ambiente de execução.

Funções exigidas

Para receber as permissões necessárias para gerenciar um ambiente de execução do Colab Enterprise, peça ao administrador para conceder a você o papel de usuário do IAM do Colab Enterprise (roles/aiplatform.colabEnterpriseUser) 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 por meio de papéis personalizados ou de outros papéis predefinidos.

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

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

Windows (PowerShell)

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

Windows (cmd.exe)

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.

Desconectar de um ambiente de execução

Para desconectar de um ambiente de execução:

  1. No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.

    Acessar "Meus cadernos"

  2. No menu Região, selecione a região que contém o notebook.

  3. Abra o notebook que você quer desconectar do ambiente de execução.

  4. Na barra de ferramentas do cabeçalho, clique em Ambiente de execução > Gerenciar sessões. Se a barra de ferramentas do cabeçalho não aparecer, clique em  Alternar visibilidade do cabeçalho.

  5. No painel Sessões ativas, clique no botão  Encerrar sessão.

  6. Clique em Encerrar.

Reconectar a um ambiente de execução

Para se reconectar a um ambiente de execução:

  1. No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.

    Acessar "Meus cadernos"

  2. No menu Região, selecione a região que contém o notebook.

  3. Abra um notebook que foi desconectado recentemente de um ambiente de execução.

  4. No canto superior direito do notebook, clique em Reconexão.

    Se o ambiente de execução ao qual o notebook estava conectado anteriormente ainda estiver em execução, o Colab Enterprise vai se conectar a ele. Se esse ambiente de execução não estiver mais em execução, ele vai se conectar ao ambiente de execução padrão.

Mudar o ambiente de execução

Para mudar o ambiente de execução ao qual você está conectado:

  1. No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.

    Acessar "Meus cadernos"

  2. No menu Região, selecione a região que contém o notebook.

  3. Abra um notebook conectado a um ambiente de execução.

  4. No canto superior direito do notebook, clique em  Opções de conexão adicionais > Mudar o tipo de execução.

  5. Preencha a caixa de diálogo para se conectar a um ambiente de execução.

Excluir um ambiente de execução

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

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

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

Windows (PowerShell)

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

Windows (cmd.exe)

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.

A seguir