Excluir uma implantação

Esta página descreve como excluir uma implantação do Infrastructure Manager.

Nesta página, consideramos que você já conhece o Terraform. Para mais detalhes, consulte Terraform e Infrastructure 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 que o Infrastructure Manager usou 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 você quer excluir.
  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 permissões necessárias para usar o serviço Infra Manager.

Para detalhes sobre 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, ele armazena metadados sobre a implantação, a configuração do Terraform que é implantada e o arquivo de estado.

Ao excluir uma implantação, você também exclui esses metadados e arquivos. Também é possível excluir ou manter os recursos provisionados pela implantação.

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 projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID/revisions/REVISION_ID

    Substitua:

    • PROJECT_ID: o ID do projeto em que o Gerenciador de infraestrutura é executado.
    • LOCATION: o local em que o Infra Manager é executado. Consulte Locais do Gerenciador de infraestrutura para conferir a lista de locais válidos.
    • DEPLOYMENT_ID: o identificador de implantação que você especifica. Consulte Nome da implantação para saber mais 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 saber mais sobre as restrições no identificador de revisão.

  2. Visualize a exclusão dos recursos. Para mais detalhes, consulte Visualizar uma 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 Gerenciador de infraestrutura é executado.
    • LOCATION: o local em que o Infra Manager é executado. Consulte Locais do Gerenciador de infraestrutura para conferir a lista de locais válidos.
    • DEPLOYMENT_ID: o identificador de implantação que você especifica. Consulte Nome da implantação para saber mais sobre as restrições no identificador de implantação.

Manter recursos provisionados

Você pode excluir a implantação e manter os recursos do Google Cloud que foram provisionados pela implantação.

Por exemplo, você implanta uma configuração dos blueprints e módulos do Terraform para Google Cloud. Depois de implantar, você quer gerenciar os recursos pelo console, e não usar a infraestrutura como código (IaC). Nesse caso, é recomendável excluir a implantação, já que você 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 Gerenciador de infraestrutura é executado.
  • LOCATION: o local em que o Infra Manager é executado. Consulte Locais do Gerenciador de infraestrutura para conferir a lista de locais válidos.
  • DEPLOYMENT_ID: o identificador de implantação que você especifica. Consulte Nome da implantação para saber mais sobre as restrições no identificador de implantação.

A seguir