Pour utiliser Infrastructure Manager (Infra Manager), vous devez connaître Terraform. Pour en savoir plus sur Terraform, commencez par la page Qu'est-ce que Terraform ? de HashiCorp.
Infra Manager déploie les ressources et les 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 (modèle) pour désigner une configuration Terraform.
Pour en savoir plus sur Terraform avec Google Cloud, consultez la page Terraform sur Google Cloud.
Modules Terraform pour Google Cloud
Pour obtenir un ensemble de modules permettant de provisionner des ressources Google Cloud , consultez les plans et modules Terraform pour Google Cloud.
Vous pouvez également créer vos propres modules Terraform pour Google Cloud. Pour en savoir plus, consultez la section Créer des modules.
Versions Terraform compatibles
Infra Manager est compatible avec les versions Terraform suivantes:
- Version Terraform 1.2.3
- Terraform version 1.3.10
- Terraform version 1.4.7
- Terraform version 1.5.7
Vous pouvez utiliser l'option --tf-version-constraint pour spécifier la version de Terraform utilisée par Infra Manager 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 compatible 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 pour déployer une configuration Terraform, la configuration doit respecter les contraintes suivantes.
- N'incluez pas d'informations personnelles ou sensibles dans les valeurs de configuration Terraform. Pour en savoir plus, consultez la section suivante 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 n'est pas prise en charge.
- La configuration doit pouvoir être activée par une version compatible de Terraform.
- Les blocs 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 la section Les provisionneurs sont un dernier recours. Si vous utilisez des provisionneurs, notez que l'environnement d'exécution d'Infra Manager peut changer à tout moment.
Valeurs de configuration Terraform et données sensibles
N'incluez pas d'informations personnelles ou sensibles dans les valeurs de configuration Terraform.
La documentation du fournisseur Google Cloud indique les valeurs de configuration pouvant 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 Google Cloud documentation du fournisseur.
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 manière 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.
Étape suivante
- En savoir plus sur Infrastructure Manager
- Créer un déploiement
- Mettre à jour un déploiement
- Afficher l'état d'un déploiement
- Supprimez un déploiement.