Esta página descreve como exportar e rever os resultados de uma pré-visualização. Uma pré-visualização descreve as ações para acionar uma configuração específica do Terraform. Antes de criar uma nova implementação ou atualizar uma implementação, pode pré-visualizar a implementação para verificar o que está planeado alterar.
Se ainda não criou a pré-visualização que quer ver, consulte o artigo Pré-visualize uma implementação.
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
- Ative o Infra Manager.
- Certifique-se de que tem as autorizações de IAM necessárias para exportar
pré-visualizações:
roles/config.admin. - Crie uma implementação de pré-visualização.
Exporte os resultados da pré-visualização
Para rever os resultados de uma pré-visualização, comece por exportá-los. Em seguida, veja os resultados exportados com uma ferramenta adequada.
Para exportar uma pré-visualização, o respetivo estado tem de ser SUCCEEDED ou
STALE. Pode ver o estado atual de uma pré-visualização através dos comandos describe ou list.
Exporte os resultados de uma pré-visualização e guarde-os localmente com o seguinte comando:
gcloud infra-manager previews export projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID
Substituição:
- 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.
- PREVIEW_ID: o identificador de pré-visualização que especificar. Consulte o Nome de pré-visualização para ver detalhes sobre as restrições do identificador de pré-visualização.
Veja os resultados da pré-visualização
Os resultados são exportados em dois formatos: o ficheiro de plano binário e a representação JSON. Pode usar qualquer um dos formatos para rever os resultados. Para ver os resultados, use uma ferramenta adequada para o formato.
Reveja o ficheiro do plano binário
Para ver o ficheiro do plano binário:
Valide que tem a CLI do Terraform instalada.
Verifique se a configuração do Terraform que usou para criar a pré-visualização está presente localmente e inicializada com
terraform init.Imprima o plano proposto através de
terraform show.
Reveja a representação JSON
Para ver a representação JSON, pode usar o seu IDE ou ferramentas como o jq.
Para aplicar restrições de políticas, pode usar a representação JSON com ferramentas como o Terraform vet.
Veja os detalhes da alteração e da variação do recurso
Pode usar pré-visualizações para ver a variação de recursos da sua implementação. A visualização da variação de recursos para as suas implementações é útil para verificar se as alterações às suas configurações são intencionais e para resumir como a sua implementação vai mudar quando é atualizada com uma pré-visualização específica.
Quando cria uma pré-visualização, usa a API Infra Manager para ver as alterações aos seus recursos à medida que atualiza as implementações.
Veja a variação de recursos
Para ver uma lista de desvios de recursos de uma implementação de pré-visualização:
gcloud infra-manager resource-drifts list --preview=projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID
Substituição:
- PROJECT_ID: o identificador do projeto onde a implementação de pré-visualização está localizada. Google Cloud
- LOCATION: a região ou a zona da implementação de pré-visualização.
- PREVIEW_ID: o identificador da implementação de pré-visualização.
Veja os detalhes de uma deriva
Para ver os detalhes de uma variação de recursos de uma implementação de pré-visualização:
gcloud infra-manager resource-drifts describe projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID/resourceDrifts/RESOURCE_DRIFT_ID
Substituição:
- PROJECT_ID: o identificador do projeto onde a implementação de pré-visualização está localizada. Google Cloud
- LOCATION: a região ou a zona da implementação de pré-visualização.
- PREVIEW_ID: o identificador da implementação de pré-visualização.
- RESOURCE_DRIFT_ID: o identificador da degradação.
Pré-visualize as alterações aos recursos
Pode usar as pré-visualizações para verificar como os seus recursos vão mudar se atualizar uma implementação a partir da pré-visualização.
Veja as alterações aos recursos
Para ver uma lista das alterações de recursos de uma implementação de pré-visualização:
gcloud infra-manager resource-changes list --preview=projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID
Substituição:
- PROJECT_ID: o identificador do projeto onde a implementação de pré-visualização está localizada. Google Cloud
- LOCATION: a região ou a zona da implementação de pré-visualização.
- PREVIEW_ID: o identificador da implementação de pré-visualização.
Veja os detalhes de uma alteração de recurso
Para ver os detalhes de uma alteração de recurso de uma implementação de pré-visualização:
gcloud infra-manager resource-changes describe projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID/resourceChanges/RESOURCE_CHANGE_ID
Substituição:
- PROJECT_ID: o identificador do projeto onde a implementação de pré-visualização está localizada. Google Cloud
- LOCATION: a região ou a zona da implementação de pré-visualização.
- PREVIEW_ID: o identificador da implementação de pré-visualização.
- RESOURCE_CHANGE_ID: o identificador da alteração do recurso.
O que se segue?
- Ver e listar pré-visualizações.
- Implemente recursos.
- Saiba mais sobre o Terraform com Google Cloud.
- Atualize uma implementação.
- Veja o estado de uma implementação.
- Veja os recursos implementados.
- Elimine uma implementação.