Excluir uma implantação

Nesta página, descrevemos como excluir uma implantação do Infrastructure Manager.

Nesta página, presumimos 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 por último 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 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 à configuração

Para excluir recursos 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 detalhes sobre como conceder permissões para os recursos 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.

Ao excluir um deployment, você exclui esses metadados e arquivos. Você também pode 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 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 mais detalhes sobre as restrições do 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 mais detalhes sobre as restrições do identificador de revisão.

  2. Visualize 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 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 mais detalhes sobre as restrições do 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 Google Cloud. Depois da implantação, você quer gerenciar os recursos pelo console, sem usar a infraestrutura como código (IaC). Nesse caso, talvez seja melhor excluir a implantação, já que você não tem uso para os metadados dela.

Para excluir os metadados da 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 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 mais detalhes sobre as restrições do identificador de implantação.

A seguir