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.
  • Interromper 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 a que 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 do IAM de Usuário 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 Google Cloud , a CLI gcloud ou a API REST.

Console

Para iniciar 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 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 tempo de execução usando a linha de comando, consulte a documentação da CLI gcloud.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

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

Método HTTP e URL: 

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start

Para enviar a solicitação, escolha uma destas opções:

curl

execute o seguinte comando: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"

PowerShell

Execute o seguinte comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Para mais informações, consulte a documentação da API REST do notebookRuntimes.start.

Parar um ambiente de execução

Para interromper um ambiente de execução, use a CLI gcloud ou a API REST.

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 stop RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

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

Windows (cmd.exe)

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

Para mais informações sobre o comando para interromper um ambiente de execução usando a linha de comando, consulte a documentação da CLI gcloud.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

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

Método HTTP e URL: 

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start

Para enviar a solicitação, escolha uma destas opções:

curl

execute o seguinte comando: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"

PowerShell

Execute o seguinte comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Para mais informações, consulte a documentação da API REST do notebookRuntimes.stop.

Desconectar de um ambiente de execução

Para se desconectar de um ambiente de execução:

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

    Acessar "Meus notebooks"

  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 a 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 Google Cloud , acesse a página Meus notebooks do Colab Enterprise.

    Acessar "Meus notebooks"

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

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

Mudar o ambiente de execução

Para mudar o ambiente de execução conectado:

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

    Acessar "Meus notebooks"

  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  Outras opções de conexão > Mudar tipo de ambiente de execução.

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

Excluir um ambiente de execução

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

Console

Para excluir 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 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 tempo de execução usando a linha de comando, consulte a documentação da CLI gcloud.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

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

Método HTTP e URL: 

DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID

Para enviar a solicitação, escolha uma destas opções:

curl

execute o seguinte comando: 

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID"

PowerShell

Execute o seguinte comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID" | Select-Object -Expand Content
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Para mais informações, consulte a documentação da API REST do notebookRuntimes.delete.

A seguir