Excluir uma implantação

O Infrastructure Manager permite remover implantações que não são mais necessárias. A exclusão de uma implantação remove os metadados e o estado dela, com a opção de excluir ou reter os recursos provisionados subjacentes.

Neste documento, presumimos que você já conhece o Terraform. Para mais detalhes, consulte Terraform e Infra Manager.

Antes de começar

  1. Verifique se o Infra Manager está ativado.
  2. Verifique se você tem as permissões do IAM necessárias para criar implantações: roles/config.admin.
  3. Verifique se a conta de serviço usada pela última vez para criar ou atualizar a implantação ainda é válida. O Infra Manager usa essa conta de serviço para excluir a implantação.
  4. Verifique se a configuração do Terraform usada pelo Infra Manager para criar ou atualizar a implantação ainda é válida. O Infra Manager usa essa configuração para excluir a implantação.
  5. Identifique a implantação do Infra Manager que será excluída.
  6. Verifique se a conta de serviço tem as permissões do IAM necessárias para excluir recursos nos projetos e locais especificados.

Conceder permissões específicas para a configuração

Para excluir recursos do Google Cloud em uma implantação específica, a conta de serviço usada para chamar o Infra Manager precisa de permissões específicas para o que você está excluindo.

Essas permissões são adicionais às necessárias para usar o serviço do Infra Manager.

Para saber como conceder permissões para os recursos do Google Cloud e garantir que você tenha acesso aos projetos necessários, consulte Configurar a conta de serviço.

Excluir uma implantação

Quando uma implantação do Infra Manager é criada, o Infra Manager armazena metadados sobre a implantação, a configuração do Terraform que é implantada e o arquivo de estado.

Quando você exclui uma implantação, esses metadados e arquivos são excluídos. Também é possível excluir os recursos provisionados pela implantação ou mantê-los.

Excluir recursos provisionados

Para excluir os metadados de implantação e os recursos provisionados:

  1. Se quiser, liste os recursos provisionados pela implantação:

    gcloud infra-manager resources list --revision=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID/revisions/REVISION_ID

    Substitua:

    • PROJECT_ID: o ID do projeto em que o Infrastructure Manager é executado.
    • LOCATION: o local em que o Infra Manager é executado. Consulte os locais do Infrastructure Manager para ver a lista de locais válidos.
    • DEPLOYMENT_ID: o identificador de implantação que você especifica. Consulte Nome da implantação para detalhes sobre as restrições no identificador de implantação.
    • REVISION_ID: o ID da revisão que representa uma revisão específica de uma implantação. Consulte Nome da implantação para detalhes sobre as restrições no identificador de revisão.

  2. Visualizar a exclusão dos recursos. Para mais detalhes, consulte Visualizar a exclusão de uma implantação.

  3. Exclua a implantação e os recursos provisionados:

    gcloud infra-manager deployments delete projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID

    Substitua:

    • PROJECT_ID: o ID do projeto em que o Infrastructure Manager é executado.
    • LOCATION: o local em que o Infra Manager é executado. Consulte os locais do Infrastructure Manager para ver a lista de locais válidos.
    • DEPLOYMENT_ID: o identificador de implantação que você especifica. Consulte Nome da implantação para detalhes sobre as restrições no identificador de implantação.

Manter recursos provisionados

Talvez você queira excluir a implantação e manter os recursos do Google Cloud que foram provisionados por ela.

Por exemplo, você implanta uma configuração dos blueprints e módulos do Terraform para o Google Cloud. Depois da implantação, você quer gerenciar os recursos pelo console e não usar a infraestrutura como código (IaC). Nesse caso, talvez você queira excluir a implantação, já que não vai usar os metadados dela.

Para excluir os metadados de implantação e manter os recursos provisionados:

gcloud infra-manager deployments delete projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
    --delete-policy=abandon

Substitua:

  • PROJECT_ID: o ID do projeto em que o Infrastructure Manager é executado.
  • LOCATION: o local em que o Infra Manager é executado. Consulte os locais do Infrastructure Manager para ver a lista de locais válidos.
  • DEPLOYMENT_ID: o identificador de implantação que você especifica. Consulte Nome da implantação para detalhes sobre as restrições no identificador de implantação.

A seguir