Elimina uma implementação.

Esta página descreve como eliminar uma implementação do Infrastructure Manager.

Esta página pressupõe que tem conhecimentos sobre o Terraform. Para ver detalhes, consulte o artigo Terraform e Infrastructure Manager.

Antes de começar

  1. Certifique-se de que o Infra Manager está ativado.
  2. Certifique-se de que tem as autorizações de IAM necessárias para criar implementações: roles/config.admin.
  3. Certifique-se de que a conta de serviço usada pela última vez para criar ou atualizar a implementação ainda é válida. O Infra Manager usa esta conta de serviço para eliminar a implementação.
    • Para ver detalhes sobre a configuração da conta de serviço, incluindo a configuração das autorizações necessárias, consulte o artigo Configure a conta de serviço.
    • Para determinar a conta de serviço que foi usada pela última vez para a implementação, consulte Veja o estado de uma revisão.
  4. Certifique-se de que a configuração do Terraform que o Infra Manager usou para criar ou atualizar a implementação ainda é válida. O Infra Manager usa esta configuração para eliminar a implementação.
  5. Identifique a implementação do Infra Manager a eliminar.
  6. Certifique-se de que a conta de serviço tem as autorizações de IAM necessárias para eliminar recursos nos projetos e localizações especificados.

Conceda autorizações específicas da configuração

Para eliminar Google Cloud recursos numa implementação específica, a conta de serviço que usa para chamar o Infra Manager precisa de autorizações específicas para o que está a eliminar.

Estas autorizações são adicionais às autorizações necessárias para usar o serviço Infra Manager.

Para ver detalhes sobre a concessão de autorizações para os Google Cloud recursos e garantir que tem acesso aos projetos necessários, consulte o artigo Configure a conta de serviço.

Elimina uma implementação.

Quando é criada uma implementação do Infra Manager, o Infra Manager armazena metadados sobre a implementação, a configuração do Terraform que é implementada e o ficheiro de estado.

Quando elimina uma implementação, elimina estes metadados e ficheiros. Também pode eliminar os recursos aprovisionados pela implementação ou manter estes recursos.

Elimine recursos aprovisionados

Para eliminar os metadados de implementação e os recursos aprovisionados:

  1. Opcionalmente, liste os recursos aprovisionados pela implementação:

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

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto onde o Infrastructure Manager é executado.
    • LOCATION: a localização onde o Infra Manager é executado. Consulte as localizações do Infrastructure Manager para ver a lista de localizações válidas.
    • DEPLOYMENT_ID: o identificador de implementação que especifica. Consulte o artigo Nome da implementação para ver detalhes sobre as restrições no identificador de implementação.
    • REVISION_ID: o ID de revisão que representa uma revisão específica de uma implementação. Consulte o Nome da implementação para ver detalhes sobre as restrições do identificador de revisão.

  2. Pré-visualize a eliminação dos recursos. Para obter detalhes, consulte o artigo Pré-visualize a eliminação de uma implementação.

  3. Elimine a implementação e os recursos aprovisionados:

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

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto onde o Infrastructure Manager é executado.
    • LOCATION: a localização onde o Infra Manager é executado. Consulte as localizações do Infrastructure Manager para ver a lista de localizações válidas.
    • DEPLOYMENT_ID: o identificador de implementação que especifica. Consulte o artigo Nome da implementação para ver detalhes sobre as restrições no identificador de implementação.

Mantenha os recursos aprovisionados

Pode querer eliminar a implementação e manter os Google Cloud recursos que foram aprovisionados pela implementação.

Por exemplo, implementa uma configuração a partir dos projetos e módulos do Terraform para Google Cloud. Depois de implementada, quer gerir os recursos através da consola e não usar a infraestrutura como código (IaC). Neste caso, pode querer eliminar a implementação, uma vez que não tem utilidade para os metadados da implementação.

Para eliminar os metadados de implementação e manter os recursos aprovisionados:

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto onde o Infrastructure Manager é executado.
  • LOCATION: a localização onde o Infra Manager é executado. Consulte as localizações do Infrastructure Manager para ver a lista de localizações válidas.
  • DEPLOYMENT_ID: o identificador de implementação que especifica. Consulte o artigo Nome da implementação para ver detalhes sobre as restrições no identificador de implementação.

O que se segue?