MemoriaGCP

tekio.org

Infrastructure Manager

Projet GCPDépôt Terraformmodules, variablesCloud Buildexécution éphémèreInfrastructure Managerdéploiements, révisionsCompte de serviceroles/config.agentRessources du projetVPC, GKE, Cloud SQLCloud Storageétat, journaux, copie123456
  1. La configuration Terraform vient d'un dépôt Git, d'un bucket Cloud Storage ou d'un répertoire local ; son point d'entrée doit être un module racine, sans bloc backend.
  2. Terraform s'exécute sous l'identité d'un compte de service dédié, porteur du rôle Infra Manager Agent et des droits sur les ressources visées.
  3. Une prévisualisation exécute terraform plan et liste créations, modifications et suppressions, sans rien toucher.
  4. Chaque déploiement crée un job Cloud Build éphémère, sur une image maintenue par Google, qui enchaîne terraform init, validate puis apply.
  5. Le plan est appliqué : les ressources du projet sont créées, modifiées ou supprimées pour rejoindre l'état décrit.
  6. Le service crée un bucket où il dépose, pour chaque révision, les journaux, une copie de la configuration et le fichier d'état Terraform.

Ce que c'est

Terraform exécuté et entretenu par Google Cloud : on fournit la configuration, le service se charge du moteur, de l'état et des journaux. La documentation l'abrège en Infra Manager et appelle blueprint une configuration Terraform.

  • Déploiement et révisions. Le déploiement est l'unité de gestion ; chaque application d'une configuration en produit une révision, qui conserve ses journaux, la configuration employée, la liste des ressources produites et le fichier d'état. Un même déploiement peut provisionner dans plusieurs régions et plusieurs projets.
  • Sources acceptées : bucket Cloud Storage (versionné par Object Versioning), dépôt Git, ou répertoire local. Le point d'entrée doit être un module racine Terraform valide ; les blocs backend sont interdits, la génération de code Terraform n'est pas acceptée, et les provisioners déconseillé sont à éviter : Terraform les réserve aux cas qu'aucune ressource déclarative ne couvre.
  • Prévisualisation. gcloud infra-manager previews create exécute un terraform plan et décrit les actions prévues, pour une création comme pour une mise à jour.
  • Exécution. Le service crée un job Cloud Build éphémère, sur une image qu'il maintient, qui télécharge le module, puis enchaîne terraform init, terraform validate et terraform apply — ou terraform destroy à la suppression. Certaines pannes passagères sont réessayées automatiquement, un nombre limité de fois. La version de Terraform se choisit par déploiement avec --tf-version-constraint ; elle peut être relevée lors d'une mise à jour, jamais abaissée.
  • État verrouillé. Le fichier d'état vit dans un bucket gs://PROJECT_NUMBER-LOCATION-blueprint-config créé par le service. Pour l'inspecter ou le corriger — importer une ressource, en retirer une — il faut verrouiller le déploiement (deployments lock), télécharger l'état par une URL signée, le modifier, le réimporter, puis déverrouiller. Le verrou empêche toute autre opération pendant ce temps.
  • Compte de service. Créer, mettre à jour ou supprimer un déploiement exige un compte de service : c'est sous son identité que Terraform s'exécute. Il porte le rôle Infra Manager Agent (roles/config.agent) et les droits sur les ressources visées ; l'utilisateur, lui, doit avoir roles/iam.serviceAccountUser sur ce compte. Consulter un déploiement n'en demande pas.
  • Facturation : rien pour le service, tout pour ce qu'il consomme — minutes Cloud Build et stockage Cloud Storage.

À quoi ça sert

  • Tenir l'infrastructure d'un projet en Terraform sans héberger soi-même l'état, les verrous ni les runners.
  • Faire du GitOps d'infrastructure : branché sur un dépôt par un déclencheur Cloud Build, une pull request produit une prévisualisation, la fusion applique la révision.
  • Donner une trace auditable : chaque révision garde sa configuration, ses journaux et son état, consultables depuis la console ou gcloud.
  • Restreindre le pouvoir d'application à un compte de service, plutôt que de distribuer des droits de création à chaque développeur.

À éviter pour déployer des applications sur les ressources ainsi créées : Infra Manager s'arrête à l'infrastructure, le déploiement applicatif relève de Cloud Build et Cloud Deploy. À éviter également quand l'équipe pilote déjà tout depuis Kubernetes — Config Connector y répond mieux — ou quand la chaîne Terraform existante repose sur des espaces de travail, des greffons et des provisioners que le service n'accepte pas.

Une révision peut remplacer ou supprimer une ressource ; le service ne migre pas les données et ne garantit aucune continuité de service. Réappliquer la révision précédente ne ramène pas les données perdues.

Alternatives en logiciel libre

  • OpenTofu : fork de Terraform sous licence MPL-2.0, hébergé par la Linux Foundation ; c'est l'équivalent libre du moteur. Terraform lui-même est sous licence BSL : source disponible, mais pas un logiciel libre.
  • Atlantis : licence Apache 2.0, exécute plan sur chaque pull request et apply à la fusion, en commentant le fil — exactement le rôle de la prévisualisation et de l'automatisation par dépôt.
  • Terragrunt : licence MIT, couche d'organisation au-dessus d'OpenTofu ou Terraform pour les environnements multiples.
  • Pulumi : licence Apache 2.0 pour le moteur et les fournisseurs, infrastructure décrite dans un vrai langage de programmation ; le service d'état hébergé est payant, mais un backend local ou sur object storage fonctionne.
  • Crossplane : licence Apache 2.0, projet CNCF, même intention depuis Kubernetes plutôt que depuis un moteur Terraform.
  • Ansible : licence GPLv3, approche procédurale et sans état, adaptée quand la configuration des machines compte autant que la création des ressources.

Documentation