Exportar e conferir os resultados da visualização

Esta página descreve como exportar e analisar os resultados de uma visualização. Uma prévia descreve as ações para acionar uma configuração específica do Terraform. Antes de criar ou atualizar uma implantação, é possível conferir uma prévia dela para verificar o que está planejado para mudar.

Se você ainda não criou a visualização que quer conferir, consulte Visualizar uma implantação.

Nesta página, consideramos que você já conhece o Terraform. Para mais detalhes, consulte Terraform e Infrastructure Manager.

Antes de começar

  1. Ativar o Infra Manager.
  2. Verifique se você tem as permissões do IAM necessárias para exportar visualizações: roles/config.admin.

Exportar os resultados da visualização

Para analisar os resultados de uma prévia, exporte-os primeiro. Em seguida, confira os resultados exportados usando uma ferramenta adequada.

Para exportar uma visualização, o estado dela precisa ser SUCCEEDED ou STALE. É possível conferir o estado atual de uma visualização usando os comandos "describe" ou "list".

Exporte os resultados de uma visualização e salve-os localmente usando o seguinte comando:

gcloud infra-manager previews export projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_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.
  • PREVIEW_ID: o identificador de visualização especificado. Consulte Nome da visualização para saber mais sobre as restrições do identificador de visualização.

Conferir os resultados da visualização

Os resultados são exportados em dois formatos: o planfile binário e a representação JSON. Você pode usar qualquer um dos formatos para analisar os resultados. Para conferir os resultados, use uma ferramenta adequada para o formato.

Analisar o arquivo de plano binário

Para conferir o arquivo de plano binário:

  1. Verifique se você instalou a CLI do Terraform.

  2. Verifique se a configuração do Terraform usada para criar a visualização está presente localmente e inicializada com terraform init.

  3. Imprima o plano proposto usando terraform show.

Analisar a representação JSON

Para conferir a representação JSON, use seu ambiente de desenvolvimento integrado ou ferramentas como o jq.

Para aplicar restrições de política, use a representação JSON com ferramentas como o Terraform vet.

A seguir