Pour utiliser Infrastructure Manager (Infra Manager), vous devez connaître Terraform. Pour en savoir plus sur Terraform, commencez par Qu'est-ce que Terraform ?.
Infra Manager déploie les ressources et configurations d'infrastructure définies dans une configuration Terraform. Ces configurations peuvent comporter plusieurs fichiers et répertoires, mais leur point d'entrée doit être un module racine Terraform.
Infra Manager utilise le terme blueprint pour désigner une configuration Terraform.
Pour en savoir plus sur Terraform avec Google Cloud, consultez Terraform sur Google Cloud.
Modules Terraform pour Google Cloud
Pour obtenir un ensemble de modules permettant de provisionner des ressources Google Cloud , consultez Plans et modules Terraform pour Google Cloud.
Vous pouvez également créer vos propres modules Terraform pour Google Cloud. Pour en savoir plus, consultez Créer des modules.
Versions Terraform compatibles
Infrastructure Manager est compatible avec les versions Terraform suivantes :
- Version 1.2.3 de Terraform
- Version 1.3.10 de Terraform
- Version 1.4.7 de Terraform
- Version 1.5.7 de Terraform
Vous pouvez utiliser l'option --tf-version-constraint pour spécifier la version de Terraform qu'Infra Manager utilise pour créer un déploiement.
Si vous ne spécifiez pas de version de Terraform, la dernière version compatible est utilisée par défaut.
Lorsque vous mettez à jour un déploiement, vous pouvez remplacer la version de Terraform par une version ultérieure. Vous ne pouvez pas passer à une version antérieure de Terraform.
Pour afficher la version de Terraform utilisée pour créer un déploiement ou une révision spécifique, consultez Afficher les détails d'un déploiement et Afficher les détails d'une révision.
Contraintes sur les configurations Terraform
Pour utiliser Infrastructure Manager afin de déployer une configuration Terraform, celle-ci doit respecter les contraintes suivantes.
- N'incluez pas d'informations personnelles ni sensibles dans les valeurs de configuration Terraform. Pour en savoir plus, consultez la section Valeurs de configuration Terraform et données sensibles.
- Vous devez fournir un module racine Terraform valide. La création de modèles ou la génération de Terraform ne sont pas acceptées.
- La configuration doit être actionnable par une version de Terraform compatible.
- Les blocs de backend ne doivent pas être définis.
- L'utilisation de provisionneurs n'est pas recommandée. Si possible, utilisez une autre solution. Pour en savoir plus sur les provisionneurs, consultez Les provisionneurs sont une solution de dernier recours. Si vous utilisez des provisionneurs, notez que l'environnement d'exécution Infra Manager peut changer à tout moment.
Valeurs de configuration Terraform et données sensibles
N'incluez pas d'informations personnelles ni sensibles dans les valeurs de configuration Terraform.
La documentation du fournisseur Google Cloud indique les valeurs de configuration qui peuvent potentiellement inclure des informations sensibles.
Par exemple, la ressource google_storage_bucket_object permet de créer un objet Cloud Storage à l'aide de l'argument content. Cet argument est marqué comme sensible sur la page google_storage_bucket_object de la documentation du fournisseur. Google Cloud
Vous pouvez utiliser ces libellés pour vous guider lorsque vous créez des configurations Terraform ou lorsque vous examinez une configuration Terraform existante avant de l'utiliser.
Consultez l'Avis de confidentialité deGoogle Cloud pour en savoir plus sur la façon dont Google Cloud traite les informations personnelles qu'il collecte ou génère lors de la fourniture et de l'administration des Services cloud.
Utiliser le fournisseur Terraform pour Google Cloud
Vous pouvez configurer les déploiements et les aperçus pour qu'ils utilisent les fournisseurs Terraform gérés par Infra Manager pour Google Cloud.
Ce champ facultatif vous permet de spécifier l'utilisation des fournisseurs Terraform gérés par Infra Manager pour créer ou mettre à jour un déploiement ou un aperçu de déploiement. Vous pouvez spécifier un fournisseur Terraform à l'aide de gcloud CLI.
Infra Manager est compatible avec les fournisseurs Terraform pour Google Cloud :
googlegoogle-beta
Omettez ce champ pour utiliser le fournisseur Terraform géré par HashiCorp pour Google Cloud.
Pour savoir comment spécifier l'utilisation d'un fournisseur Terraform géré par Infra Manager, consultez Déployer une infrastructure à l'aide d'Infrastructure Manager, Mettre à jour un déploiement ou Prévisualiser un déploiement.
Vérifier les versions compatibles du fournisseur
Pour vérifier les versions d'un fournisseur Terraform pour Google Cloud qu'Infra Manager prend en charge, vous devez afficher le manifest.json dans le bucket Cloud Storage géré par Infra Manager associé à la région de votre déploiement au format suivant :
https://storage.googleapis.com/LOCATION-im-providers/hashicorp/PROVIDER_VERSION/manifest.json
Vous trouverez la liste complète des versions compatibles dans le champ versions du fichier manifest.json.
Par exemple, si votre déploiement se trouve dans la région africa-south1 et que vous utilisez le fournisseur google-beta, accédez à https://storage.googleapis.com/africa-south1-im-providers/hashicorp/google-beta/manifest.json pour afficher les régions disponibles.
Étapes suivantes
- En savoir plus sur Infrastructure Manager
- Créer un déploiement
- Mettre à jour un déploiement
- Affichez l'état d'un déploiement.
- Supprimez un déploiement.