Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Infrastructure Manager (Infra Manager) automatiza la implementación y la administración de los recursos de infraestructura de Google Cloud con Terraform.
Infra Manager te permite implementar de manera programática en Google Cloud, lo que te permite usar este servicio en lugar de mantener una cadena de herramientas diferente para trabajar con Terraform en Google Cloud.
Una configuración de Terraform define la infraestructura. Infra Manager implementa la configuración en Google Cloud , lo que te permite administrar los recursos con la infraestructura como código (IaC).
Infra Manager no administra la implementación de aplicaciones en tus recursos. Para administrar la implementación de aplicaciones, puedes usar Google Cloud
productos como Cloud Build y
Cloud Deploy. También puedes usar herramientas de terceros o tu propia cadena de herramientas.
Para trabajar con Infra Manager, debes conocer Terraform.
Para obtener más información sobre Terraform, comienza con ¿Qué es Terraform? de HashiCorp.
Infra Manager te permite usar IaC para administrar el ciclo de vida de los recursosGoogle Cloud :
Terraform se define de forma declarativa en una configuración de Terraform. Esto significa que la configuración describe el estado final de tu infraestructura.
Puedes crear versiones de la configuración de Terraform en un repositorio de Git o
en un
bucket de Cloud Storage.
Usa el control de versiones de objetos para crear versiones de configuraciones en un bucket de almacenamiento.
Usa Infra Manager para actualizar la implementación de tu infraestructura con revisiones. Para cada revisión, Infra Manager almacena lo siguiente:
Registros
La configuración que se usó para hacer la revisión
La lista de Google Cloud recursos creados por la revisión
El archivo de estado que se crea como parte de cada implementación y revisión
Puedes almacenar la configuración de Terraform en un bucket de Cloud Storage, un repositorio de
Git o en tu máquina local.
Cuando usas Infra Manager para implementar recursos desde una configuración de Terraform, creas una implementación. Para crear una implementación,
Infra Manager hace lo siguiente:
Valida la solicitud. Por ejemplo, se asegura de que, en tu comando, hayas especificado la ubicación de la configuración de Terraform.
Crea un trabajo de Cloud Build con una imagen de contenedor. Google Cloudes el propietario y el encargado del mantenimiento de esta imagen. Consulta Entorno de ejecución para obtener detalles sobre el entorno de Cloud Build. El trabajo de Cloud Build automatiza las siguientes tareas:
Descarga el módulo de Terraform del bucket de almacenamiento o el repositorio de
Git.
Inicializa Terraform (terraform init).
Valida la configuración de Terraform (terraform validate).
Activa la configuración (terraform apply o terraform destroy si borras una implementación).
Transmite registros de Cloud Build a un bucket de almacenamiento creado por Infra Manager.
Si la implementación falla, Infra Manager vuelve a intentar las operaciones terraform init o terraform apply automáticamente en ciertas situaciones, por ejemplo, si falló con interrupciones intermitentes de la red. Estos reintentos se realizan una cantidad limitada de veces.
Cuando se completa la implementación, los Google Cloud recursos se aprovisionan como los describió la configuración.
Puedes consultar la implementación de Infra Manager para lo siguiente:
Es el estado de la implementación.
Es la lista de recursos que se implementan como parte de la implementación.
Detalles sobre los recursos individuales que forman parte de una implementación.
Entorno de ejecución
El entorno de ejecución de Infra Manager es un entorno efímero de Cloud Build.
Infra Manager ejecuta comandos de Terraform en este
entorno de Cloud Build y, luego, se descarta el entorno.
El sistema operativo específico, el software disponible y otros detalles de configuración del entorno de Cloud Build son detalles de implementación internos de Infra Manager y pueden cambiar en cualquier momento.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)."]]
