Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Infrastructure Manager (Infra Manager) automatise le déploiement et la gestion des ressources d'infrastructure Google Cloud à l'aide de Terraform.
Infra Manager vous permet de déployer de manière programmatique sur Google Cloud, ce qui vous permet d'utiliser ce service plutôt que de gérer une chaîne d'outils différente pour travailler avec Terraform sur Google Cloud.
Une configuration Terraform définit l'infrastructure. La configuration est déployée sur Google Cloud par Infra Manager, ce qui vous permet de gérer les ressources à l'aide de l'Infrastructure as Code (IaC).
Infra Manager ne gère pas le déploiement d'applications sur vos ressources. Pour gérer le déploiement d'applications, vous pouvez utiliser Google Cloud
des produits tels que Cloud Build et Cloud Deploy. Vous pouvez également utiliser des outils tiers ou votre propre chaîne d'outils.
Pour utiliser Infra Manager, vous devez connaître Terraform.
Pour en savoir plus sur Terraform, consultez la page Qu'est-ce que Terraform ? de HashiCorp.
Infra Manager vous permet d'utiliser l'IaC pour gérer le cycle de vie des ressourcesGoogle Cloud :
Terraform est défini de manière déclarative dans une configuration Terraform. Cela signifie que la configuration décrit l'état final de votre infrastructure.
Vous pouvez gérer la version de la configuration Terraform dans un dépôt Git ou dans un bucket Cloud Storage.
Utilisez la gestion des versions d'objets pour gérer les versions des configurations dans un bucket de stockage.
Utilisez Infra Manager pour mettre à jour le déploiement de votre infrastructure avec des révisions. Pour chaque révision, Infra Manager stocke les éléments suivants :
Journaux
Configuration utilisée pour effectuer la révision
Liste des ressources Google Cloud créées par la révision
Fichier d'état créé lors de chaque déploiement et de chaque révision
Vous trouverez ci-dessous une description de ce qui se passe dans un scénario simple lorsque vous utilisez Infra Manager pour déployer une infrastructure.
Les ressources d'infrastructure à déployer sur Google Cloud sont définies dans une configuration Terraform.
Vous pouvez créer ce fichier vous-même ou utiliser une configuration déjà écrite pour Google Cloud. Pour en savoir plus, consultez Terraform et Infrastructure Manager.
Vous pouvez stocker la configuration Terraform dans un bucket Cloud Storage, un dépôt Git ou sur votre ordinateur local.
Lorsque vous utilisez Infra Manager pour déployer des ressources à partir d'une configuration Terraform, vous créez un déploiement. Pour créer un déploiement, Infra Manager :
Valide la requête. Par exemple, il s'assure que vous avez spécifié l'emplacement de la configuration Terraform dans votre commande.
Crée une tâche Cloud Build à l'aide d'une image de conteneur. Cette image appartient à Google Cloudet est gérée par lui. Pour en savoir plus sur l'environnement Cloud Build, consultez la section Environnement d'exécution. La tâche Cloud Build automatise les tâches suivantes :
Télécharge le module Terraform à partir du bucket de stockage ou du dépôt Git.
Initialise Terraform (terraform init)
Valide la configuration Terraform (terraform validate)
Active la configuration (terraform apply ou terraform destroy si vous supprimez un déploiement)
Affiche les journaux Cloud Build dans un bucket de stockage créé par Infra Manager.
Si le déploiement échoue, Infra Manager réessaie automatiquement les opérations terraform init ou terraform apply dans certains scénarios, par exemple en cas d'échec en raison d'interruptions intermittentes du réseau. Ces tentatives sont effectuées un nombre limité de fois.
Crée un bucket Cloud Storage et stocke des métadonnées sur le déploiement. Pour en savoir plus sur le déploiement et les métadonnées, consultez la section Présentation du déploiement et des révisions.
Une fois le déploiement terminé, les ressources Google Cloud sont provisionnées comme décrit dans la configuration.
Vous pouvez interroger le déploiement d'Infra Manager pour:
État du déploiement.
Liste des ressources déployées dans le cadre du déploiement.
Informations sur les ressources individuelles qui font partie d'un déploiement.
Environnement d'exécution
L'environnement d'exécution d'Infra Manager est un environnement Cloud Build éphémère.
Infra Manager exécute les commandes Terraform dans cet environnement Cloud Build, puis l'environnement est supprimé.
Le système d'exploitation spécifique, les logiciels disponibles et d'autres détails de configuration de l'environnement Cloud Build sont des détails d'implémentation internes d'Infra Manager et peuvent changer à tout moment.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/05 (UTC)."],[[["\u003cp\u003eInfrastructure Manager automates the deployment and management of Google Cloud resources using Terraform, eliminating the need for a separate Terraform toolchain.\u003c/p\u003e\n"],["\u003cp\u003eInfra Manager uses Infrastructure as Code (IaC) principles, where Terraform configurations define the desired infrastructure state, and these configurations can be versioned in Git or Cloud Storage.\u003c/p\u003e\n"],["\u003cp\u003eDeployments in Infra Manager create a Cloud Build job, maintained by Google, which handles Terraform operations like initialization, validation, and application, as well as logging and retries in case of failure.\u003c/p\u003e\n"],["\u003cp\u003eInfra Manager does not manage application deployments, but instead focuses on provisioning the underlying Google Cloud resources, allowing users to employ other Google Cloud or third-party tools for application management.\u003c/p\u003e\n"],["\u003cp\u003eInfra Manager uses an ephemeral Cloud Build environment to execute Terraform commands, ensuring a consistent runtime environment, with the specific details of the environment being subject to change.\u003c/p\u003e\n"]]],[],null,["# Infrastructure Manager overview\n\nInfrastructure Manager (Infra Manager) automates the deployment and\nmanagement of Google Cloud infrastructure resources using Terraform.\n\nInfra Manager allows you to deploy programmatically to Google Cloud,\nallowing you to use this service rather than maintaining a different\ntoolchain to work with Terraform on Google Cloud.\n\nA Terraform configuration defines the infrastructure. The configuration is\ndeployed onto Google Cloud by Infra Manager, enabling you to\nmanage resources using Infrastructure as Code (IaC).\n\nInfra Manager does not manage the deployment of applications onto\nyour resources. To manage application deployment, you can use Google Cloud\nproducts like [Cloud Build](/build/docs) and\n[Cloud Deploy](/deploy/docs). You can also use third-party tools or your\nown toolchain.\n\nTo work with Infra Manager, you should be familiar with Terraform.\nTo learn more about Terraform, start\nwith HashiCorp's\n[What is Terraform?](https://developer.hashicorp.com/terraform/intro).\n\nTo learn more about Terraform with Google Cloud, see\n[Terraform on Google Cloud](/docs/terraform).\n\nInfra Manager and Infrastructure as Code\n----------------------------------------\n\nInfra Manager allows you to use IaC to manage the lifecycle of\nGoogle Cloud resources:\n\n- Terraform is defined declaratively in a [Terraform configuration](/infrastructure-manager/docs/terraform). This means that the configuration describes the end state of your infrastructure.\n- You can version the Terraform configuration either in a Git repository, or in a [Cloud Storage bucket](/infrastructure-manager/docs/upload-terraform-configuration). Use [Object Versioning](/storage/docs/object-versioning) to version configurations in a storage bucket.\n- Use Infra Manager to update your infrastructure deployment with [revisions](/infrastructure-manager/docs/deployments-revisions#revisions). For each revision, Infra Manager stores the following:\n - Logs\n - The configuration used to do the revision\n - The list of Google Cloud resources created by the revision\n - The state file created as part of each deployment and revision\n\nSee [Infrastructure as Code on Google Cloud](/docs/terraform/iac-overview)\nfor more information about IaC.\n\nHow Infra Manager works\n-----------------------\n\nThe following is a description of what happens in a simple scenario when you\nuse Infra Manager to deploy infrastructure.\n\n1. The infrastructure resources to deploy onto Google Cloud are defined in a Terraform configuration.\n - You can create this file yourself, or use a configuration that is already written for Google Cloud. See [Terraform and Infrastructure Manager](/infrastructure-manager/docs/terraform) for details.\n - You can store the Terraform configuration in a Cloud Storage bucket, a Git repository, or on your local machine.\n2. When you use Infra Manager to deploy resources from a Terraform configuration, you create a deployment. To create a deployment, Infra Manager:\n 1. Validates the request. For example, it ensures that in your command you specified the location of the Terraform configuration.\n 2. Creates a Cloud Build job using a container image. This image is owned and maintained by Google Cloud. See [Runtime environment](#runtime_environment) for details about the Cloud Build environment. The Cloud Build job automates the following tasks:\n 1. Downloads the Terraform module from the storage bucket or Git repository.\n 2. Initializes Terraform (`terraform init`)\n 3. Validates the Terraform configuration (`terraform validate`)\n 4. Actuates the configuration (`terraform apply`, or `terraform destroy` if you are deleting a deployment)\n 5. Streams Cloud Build logs into a storage bucket created by Infra Manager.\n 6. If the deployment fails, Infra Manager automatically retries the `terraform init` or `terraform apply` operations in certain scenarios, such as if it failed with intermittent network outages. These retries are performed a limited number of times.\n 3. Creates a Cloud Storage bucket and stores metadata about the deployment. For more information about the deployment and metadata, see [Deployment and revision overview](/infrastructure-manager/docs/deployments-revisions).\n3. When the deployment is complete, the Google Cloud resources are\n provisioned as the configuration described them.\n\n You can query Infra Manager deployment for:\n - The status of the deployment.\n - The list of resources that are deployed as part of the deployment.\n - Details about individual resources that are part of a deployment.\n\nRuntime environment\n-------------------\n\nThe runtime environment of Infra Manager is an\n[ephemeral Cloud Build environment](/build/docs/overview#ephemeral-build-environment).\nInfra Manager executes Terraform commands in this\nCloud Build environment, and then the environment is discarded.\n\nThe specific operating system, available software, and other configuration\ndetails of the Cloud Build environment are internal implementation\ndetails of Infra Manager, and can change at any time.\n\nYou can specify which\n[supported version of Terraform](/infrastructure-manager/docs/terraform#terraform_versions)\nto use for each deployment.\n\nDon't include personal or sensitive information\n-----------------------------------------------\n\nDon't include personal or sensitive information in Terraform configuration\nvalues.\n\nFor additional information about Terraform configurations and sensitive data,\nsee\n[Terraform configuration values and sensitive data](/infrastructure-manager/docs/terraform#config-values-data).\n\nWhat's next\n-----------\n\n- Learn more about [Terraform with Google Cloud](/docs/terraform).\n- [Create a deployment](/infrastructure-manager/docs/deploy-resources).\n- [Update a deployment](/infrastructure-manager/docs/update-deployment).\n- [Automate deployments](/infrastructure-manager/docs/automate-git).\n- [Delete a deployment](/infrastructure-manager/docs/delete-deployments)."]]
