Exporter et afficher les résultats de l'aperçu

Cette page explique comment exporter et examiner les résultats d'un aperçu. Un aperçu décrit les actions à effectuer pour déclencher une configuration Terraform spécifique. Avant de créer ou de mettre à jour un déploiement, vous pouvez en prévisualiser le contenu pour vérifier les modifications prévues.

Si vous n'avez pas encore créé l'aperçu que vous souhaitez afficher, consultez Prévisualiser un déploiement.

Cette page part du principe que vous connaissez Terraform. Pour en savoir plus, consultez la section Terraform et Infrastructure Manager.

Avant de commencer

  1. Activez Infra Manager.
  2. Assurez-vous de disposer des autorisations IAM nécessaires pour exporter des aperçus: roles/config.admin.

Exporter les résultats de l'aperçu

Pour examiner les résultats d'un aperçu, commencez par les exporter. Affichez ensuite les résultats exportés à l'aide d'un outil approprié.

Pour exporter un aperçu, son état doit être SUCCEEDED ou STALE. Vous pouvez afficher l'état actuel d'un aperçu à l'aide des commandes describe ou list.

Exportez les résultats d'un aperçu et enregistrez-les localement à l'aide de la commande suivante:

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

Remplacez :

  • PROJECT_ID: ID du projet sur lequel s'exécute Infrastructure Manager.
  • LOCATION: emplacement où Infra Manager s'exécute. Pour obtenir la liste des emplacements valides, consultez la section Emplacements Infrastructure Manager.
  • PREVIEW_ID: identifiant d'aperçu que vous spécifiez. Pour en savoir plus sur les contraintes liées à l'identifiant d'aperçu, consultez la section Nom de l'aperçu.

Afficher les résultats de l'aperçu

Les résultats sont exportés dans deux formats: le fichier de plan binaire et la représentation JSON. Vous pouvez utiliser l'un ou l'autre de ces formats pour examiner les résultats. Pour afficher les résultats, utilisez un outil adapté au format.

Examiner le fichier de plan binaire

Pour afficher le fichier de plan binaire:

  1. Assurez-vous d'avoir installé la CLI Terraform.

  2. Assurez-vous que la configuration Terraform que vous avez utilisée pour créer l'aperçu est présente localement et initialisée avec terraform init.

  3. Imprimez le plan proposé à l'aide de terraform show.

Examiner la représentation JSON

Pour afficher la représentation JSON, vous pouvez utiliser votre IDE ou des outils tels que jq.

Pour appliquer les contraintes de stratégie, vous pouvez utiliser la représentation JSON avec des outils tels que Terraform vet.

Étape suivante