Esportare e visualizzare i risultati dell'anteprima

Questa pagina descrive come esportare e rivedere i risultati di un'anteprima. Un'anteprima descrive le azioni per attivare una configurazione Terraform specifica. Prima di creare un nuovo deployment o aggiornarne uno esistente, puoi visualizzare in anteprima il deployment per verificare cosa è previsto che cambi.

Se non hai ancora creato l'anteprima che vuoi visualizzare, consulta Visualizzare l'anteprima di un deployment.

Questa pagina presuppone che tu abbia familiarità con Terraform. Per maggiori dettagli, vedi Terraform e Infrastructure Manager.

Prima di iniziare

  1. Abilita Infra Manager.
  2. Assicurati di disporre delle autorizzazioni IAM necessarie per esportare le anteprime: roles/config.admin.
  3. Crea un deployment di anteprima.

Esportare i risultati dell'anteprima

Per esaminare i risultati di un'anteprima, esportali prima. Poi, visualizza i risultati esportati utilizzando uno strumento appropriato.

Per esportare un'anteprima, il relativo stato deve essere SUCCEEDED o STALE. Puoi visualizzare lo stato attuale di un'anteprima utilizzando i comandi describe o list.

Esporta i risultati di un'anteprima e salvali localmente utilizzando il seguente comando:

gcloud infra-manager previews export projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

Sostituisci:

  • PROJECT_ID: l'ID del progetto in cui viene eseguito Infrastructure Manager.
  • LOCATION: la località in cui viene eseguito Infra Manager. Consulta Località di Infrastructure Manager per l'elenco delle località valide.
  • PREVIEW_ID: l'identificatore dell'anteprima che specifichi. Per informazioni dettagliate sui vincoli dell'identificatore dell'anteprima, vedi Nome anteprima.

Visualizzare i risultati dell'anteprima

I risultati vengono esportati in due formati: il file binario del piano e la rappresentazione JSON. Puoi utilizzare uno dei due formati per esaminare i risultati. Per visualizzare i risultati, utilizza uno strumento appropriato per il formato.

Esaminare il file del piano binario

Per visualizzare il file del piano binario:

  1. Verifica di aver installato la CLI Terraform.

  2. Verifica che la configurazione Terraform che hai utilizzato per creare l'anteprima sia presente localmente e inizializzata con terraform init.

  3. Stampa il piano proposto utilizzando terraform show.

Esamina la rappresentazione JSON

Per visualizzare la rappresentazione JSON, puoi utilizzare il tuo IDE o strumenti come jq.

Per applicare i vincoli dei criteri, puoi utilizzare la rappresentazione JSON con strumenti come Terraform vet.

Visualizzare i dettagli delle modifiche e della deriva delle risorse

Puoi utilizzare le anteprime per visualizzare la deriva delle risorse per la tua implementazione. La visualizzazione della deriva delle risorse per i deployment è utile per verificare che le modifiche alle configurazioni siano intenzionali e per riepilogare come cambierà il deployment quando viene aggiornato con una determinata anteprima.

Quando crei un'anteprima, utilizzi l'API Infra Manager per visualizzare le modifiche alle risorse man mano che aggiorni i deployment.

Visualizza la deriva delle risorse

Per visualizzare un elenco delle variazioni di configurazione delle risorse di un deployment di anteprima:

gcloud infra-manager resource-drifts list --preview=projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

Sostituisci:

  • PROJECT_ID: l'identificatore del progetto Google Cloud in cui si trova la tua implementazione di anteprima.
  • LOCATION: La regione o la zona del deployment di anteprima.
  • PREVIEW_ID: l'identificatore del deployment di anteprima.

Visualizzare i dettagli di una deriva

Per visualizzare i dettagli della deriva di una risorsa da un deployment di anteprima:

gcloud infra-manager resource-drifts describe projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID/resourceDrifts/RESOURCE_DRIFT_ID

Sostituisci:

  • PROJECT_ID: l'identificatore del progetto Google Cloud in cui si trova la tua implementazione di anteprima.
  • LOCATION: La regione o la zona del deployment di anteprima.
  • PREVIEW_ID: l'identificatore del deployment di anteprima.
  • RESOURCE_DRIFT_ID: l'identificatore della deriva.

Visualizzare l'anteprima delle modifiche alle risorse

Puoi utilizzare le anteprime per verificare in che modo le risorse cambieranno se aggiorni una deployment dall'anteprima.

Visualizzare le modifiche alle risorse

Per visualizzare un elenco delle modifiche alle risorse di un deployment di anteprima:

gcloud infra-manager resource-changes list --preview=projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

Sostituisci:

  • PROJECT_ID: l'identificatore del progetto Google Cloud in cui si trova la tua implementazione di anteprima.
  • LOCATION: La regione o la zona del deployment di anteprima.
  • PREVIEW_ID: l'identificatore del deployment di anteprima.

Visualizzare i dettagli di una modifica alla risorsa

Per visualizzare i dettagli di una modifica alla risorsa da un deployment di anteprima:

gcloud infra-manager resource-changes describe projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID/resourceChanges/RESOURCE_CHANGE_ID

Sostituisci:

  • PROJECT_ID: l'identificatore del progetto Google Cloud in cui si trova la tua implementazione di anteprima.
  • LOCATION: La regione o la zona del deployment di anteprima.
  • PREVIEW_ID: l'identificatore del deployment di anteprima.
  • RESOURCE_CHANGE_ID: l'identificatore della modifica della risorsa.

Passaggi successivi