Prévisualiser une mise à jour d'un déploiement

Cette page explique comment utiliser Infrastructure Manager pour prévisualiser le déploiement des ressources définies dans une configuration Terraform.

Un aperçu décrit les actions permettant d'activer une configuration Terraform spécifique. Avant de créer ou de mettre à jour un déploiement, vous pouvez le prévisualiser pour vérifier les ressources dont le provisionnement est prévu.

Un aperçu exécute la commande Terraform plan. Cette page suppose que vous connaissez déjà Terraform. Pour en savoir plus, consultez Terraform et Infrastructure Manager.

Pour créer un aperçu, la configuration Terraform doit être compatible avec l'une des versions de Terraform compatibles.

Avant de commencer

  1. Activez Infra Manager.
  2. Assurez-vous de disposer des autorisations IAM nécessaires pour créer des aperçus : roles/config.admin.
  3. Assurez-vous de disposer d'un compte de service avec les autorisations nécessaires. Pour en savoir plus, consultez Configurer le compte de service.
  4. Identifiez la configuration Terraform à prévisualiser. Assurez-vous que cette configuration Terraform respecte les contraintes, y compris qu'elle ne contient pas de données sensibles.

Prévisualiser une mise à jour d'un déploiement

La configuration Terraform que vous utilisez pour mettre à jour un déploiement peut se trouver dans un bucket de stockage ou dans un dépôt Git.

Vous utiliserez également cette configuration Terraform pour prévisualiser la mise à jour.

Prévisualiser à l'aide d'une configuration Terraform stockée dans un bucket Cloud Storage

Lorsque vous mettez à jour un déploiement, certaines des ressources existantes peuvent ne pas changer. La prévisualisation d'une mise à jour vous indique les ressources dont le provisionnement ou la suppression sont prévus, ainsi que celles qui ne seront pas modifiées.

  1. Identifiez le déploiement que vous souhaitez mettre à jour.

  2. Assurez-vous que la configuration Terraform est importée dans un bucket Cloud Storage. Pour en savoir plus, consultez Importer une configuration dans un bucket de stockage.

    Un bucket de stockage vous permet de contrôler l'accès à la configuration. Vous pouvez également déployer une configuration Terraform stockée dans un dépôt Git ou sur votre ordinateur local.

  3. Pour prévisualiser la mise à jour :

    
    












































    gcloud infra-manager previews create projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID \
--service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
--deployment=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
--gcs-source gs://BUCKET_NAME/OBJECT_NAME \
--input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
--tf-version-constraint=TERRAFORM_VERSION \
--provider-source=SERVICE_MAINTAINED

    Remplacez :

    • PROJECT_ID est l'ID du projet dans lequel Infrastructure Manager s'exécute.
    • LOCATION est l'emplacement où Infra Manager s'exécute. Pour obtenir la liste des emplacements valides, consultez Emplacements Infrastructure Manager.
    • PREVIEW_ID est l'identifiant d'aperçu que vous spécifiez. Pour en savoir plus sur les contraintes liées à l'identifiant de l'aperçu, consultez Nom de l'aperçu.
    • SERVICE_ACCOUNT est le nom du compte de service que vous utilisez pour appeler Infra Manager.
    • SERVICE_ACCOUNT_PROJECT_ID est l'ID du projet du compte de service. Il s'agit généralement du même projet que celui dans lequel Infra Manager s'exécute.
    • DEPLOYMENT_ID est l'identifiant du déploiement que vous souhaitez mettre à jour.
    • BUCKET_NAME est le nom du bucket de stockage où la configuration est stockée.

    • OBJECT_NAME est le nom d'objet du fichier de configuration. Cet objet peut être un répertoire ou un fichier ZIP, mais pas un fichier Terraform. Si vous utilisez la gestion des versions des objets, vous pouvez également spécifier le numéro de génération de l'objet. Pour en savoir plus, consultez Utiliser des objets avec des versions gérées.

      Si le bucket de stockage est le chemin d'accès racine de la configuration Terraform, OBJECT_NAME est facultatif.

    • INPUT_1_NAME=VALUE et INPUT_2_NAME=VALUE : toutes les valeurs d'entrée de la configuration Terraform, y compris celles qui ne sont pas définies par défaut. Par exemple, vous pouvez spécifier le projet dans lequel vous déployez les ressources comme suit : project_id=my-project.

      Si toutes les valeurs d'entrée sont définies par défaut dans la configuration, cette option est facultative.

    • Facultatif : TERRAFORM_VERSION : version de Terraform qu'Infra Manager doit utiliser pour prévisualiser la mise à jour du déploiement. Consultez la section Version de Terraform compatible pour obtenir la liste des versions compatibles. Si vous supprimez cette option facultative, Infra Manager utilise la version Terraform du déploiement existant ou, par défaut, la dernière version sans frais compatible (1.5.7). Les aperçus n'entraînent pas de frais pour les versions payantes de Terraform.

    • Facultatif : PROVIDER_SOURCE : détermine le fournisseur Terraform pour Google Cloud que le déploiement utilise. Définissez cette option sur SERVICE_MAINTAINED pour utiliser le fournisseur Terraform géré par Infra Manager. Omettez ce champ pour utiliser le fournisseur Terraform géré par HashiCorp. Pour en savoir plus, consultez Utiliser le fournisseur Terraform pour Google Cloud.

    Les champs du déploiement, tels que la configuration Terraform, les variables et le compte de service, sont automatiquement fusionnés dans l'aperçu, sauf si vous spécifiez de nouvelles valeurs dans la commande d'aperçu.

Maintenant que vous avez créé un aperçu, vous pouvez exporter et afficher les résultats pour examiner le plan de déploiement.

Prévisualiser à l'aide d'une configuration Terraform stockée dans un dépôt Git

Lorsque vous mettez à jour un déploiement, certaines des ressources existantes peuvent ne pas changer. La prévisualisation d'une mise à jour vous indique les ressources dont le provisionnement ou la suppression sont prévus, ainsi que celles qui ne seront pas modifiées.

  1. Si votre configuration Terraform est stockée dans un dépôt Git privé et que vous ne l'avez pas encore fait, assurez-vous de vous être connecté à votre hôte GitHub et à votre dépôt GitHub à l'aide de Cloud Build pour fournir à Infra Manager l'accès à votre dépôt.

  2. Pour mettre à jour un déploiement :

    
    












































    gcloud infra-manager previews create projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID \
--service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
--deployment=projects/PROJECT_ID/locations/LOCATION/deployments/DEPLOYMENT_ID \
--git-source-repo="GIT_REPO" \
--git-source-directory="DIRECTORY" \
--git-source-ref="REF" \
--input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
--tf-version-constraint=TERRAFORM_VERSION \
--provider-source=SERVICE_MAINTAINED

    Remplacez :

    • PROJECT_ID est l'ID du projet dans lequel Infrastructure Manager s'exécute.
    • LOCATION est l'emplacement où Infra Manager s'exécute. Pour obtenir la liste des emplacements valides, consultez Emplacements Infrastructure Manager.
    • PREVIEW_ID est l'identifiant d'aperçu que vous spécifiez. Pour en savoir plus sur les contraintes liées à l'identifiant de l'aperçu, consultez Nom de l'aperçu.
    • SERVICE_ACCOUNT est le nom du compte de service que vous utilisez pour appeler Infra Manager.
    • SERVICE_ACCOUNT_PROJECT_ID est l'ID du projet du compte de service. Il s'agit généralement du même projet que celui dans lequel Infra Manager s'exécute.
    • DEPLOYMENT_ID est l'identifiant du déploiement que vous souhaitez mettre à jour.
    • GIT_REPO : dépôt Git.
    • DIRECTORY : répertoire contenant la configuration Terraform.
    • REF : référence Git de la configuration. La référence est facultative. Si vous ne spécifiez pas de référence, la branche configurée par défaut pour le dépôt Git est utilisée.

    • INPUT_1_NAME=VALUE et INPUT_2_NAME=VALUE : toutes les valeurs d'entrée de la configuration Terraform, y compris celles qui ne sont pas définies par défaut. Par exemple, vous pouvez spécifier le projet dans lequel vous déployez les ressources comme suit : project_id=my-project.

      Si toutes les valeurs d'entrée sont définies par défaut dans la configuration, cette option est facultative.

    • Facultatif : TERRAFORM_VERSION : version de Terraform qu'Infra Manager doit utiliser pour prévisualiser la mise à jour du déploiement. Consultez la section Version de Terraform compatible pour obtenir la liste des versions compatibles. Si vous supprimez cette option facultative, Infra Manager utilise la version Terraform du déploiement existant ou, par défaut, la dernière version sans frais compatible (1.5.7). Les aperçus n'entraînent pas de frais pour les versions payantes de Terraform.

    • Facultatif : PROVIDER_SOURCE : détermine le fournisseur Terraform pour Google Cloud que le déploiement utilise. Définissez cette option sur SERVICE_MAINTAINED pour utiliser le fournisseur Terraform géré par Infra Manager. Omettez ce champ pour utiliser le fournisseur Terraform géré par HashiCorp. Pour en savoir plus, consultez Utiliser le fournisseur Terraform pour Google Cloud.

Les champs du déploiement, tels que la configuration Terraform, les variables et le compte de service, sont automatiquement fusionnés dans l'aperçu, sauf si vous spécifiez de nouvelles valeurs dans la commande d'aperçu.

Maintenant que vous avez créé un aperçu, vous pouvez exporter et afficher les résultats pour examiner le plan de déploiement.

Étapes suivantes