Gerenciar modelos de ambiente de execução

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

  • Edite um modelo de ambiente de execução.
  • Exclui um modelo de ambiente de execução.

Funções exigidas

Para ter as permissões necessárias para gerenciar um modelo de ambiente de execução do 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 papéis personalizados ou outros papéis predefinidos.

Editar um modelo de ambiente de execução

É possível mudar algumas das especificações do modelo de ambiente de execução, incluindo a versão do Python e a configuração da chave de criptografia. As mudanças feitas no modelo de ambiente de execução só serão aplicadas a novos ambientes de execução criados com base nesse modelo.

Para editar um modelo de tempo de execução, use o console do Google Cloud ou a API REST.

Console

Para editar um modelo de ambiente de execução:

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

    Acessar "Modelos de ambiente de execução"

  2. No menu Região, selecione a região que contém o modelo de ambiente de execução.

  3. Na coluna ID, clique no número do ID do modelo de execução que você quer editar.

  4. Clique em  Editar.

  5. No painel Editar modelo de ambiente de execução, faça as mudanças necessárias.

  6. Clique em Atualizar.

REST

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

  • REGION: a região em que seu modelo de tempo de execução está localizado.
  • PROJECT_ID: o ID do projeto.
  • NOTEBOOK_RUNTIME_TEMPLATE_ID: o ID do modelo de ambiente de execução.
  • RELEASE_NAME: o nome da versão da imagem que você quer usar. Por exemplo, py311 é o nome da versão da imagem do Python 3.11. Para definir a imagem como Latest, deixe RELEASE_NAME vazio.

Método HTTP e URL: 

PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name

Corpo JSON da solicitação:

{
  softwareConfig: {
    colabImage: {
      releaseName: "RELEASE_NAME"
    }
  }
}

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

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo: 

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"

PowerShell

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir: 

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

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Para informações sobre os parâmetros de consulta disponíveis, consulte a documentação da API REST notebookRuntimeTemplates.patch.

Excluir um modelo de ambiente de execução

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

Console

Para excluir um modelo de tempo de execução, faça o seguinte:

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

    Acessar "Modelos de ambiente de execução"

  2. No menu Região, selecione a região que contém o modelo de ambiente de execução.

  3. Selecione o modelo de 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 excluir 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 notebookRuntimeTemplates.delete.

A seguir