Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Infrastructure Manager (Infra Manager) automatiza a implantação e o gerenciamento de recursos de infraestrutura usando o Terraform. Google Cloud
O Infra Manager permite implantar programaticamente no Google Cloud,
permitindo que você use esse serviço em vez de manter um conjunto de ferramentas
diferente para trabalhar com o Terraform no Google Cloud.
Uma configuração do Terraform define a infraestrutura. A configuração é
implantada em Google Cloud pelo Infra Manager, permitindo que você
gerencie recursos usando infraestrutura como código (IaC).
O Infra Manager não gerencia a implantação de aplicativos nos seus recursos. Para gerenciar a implantação de aplicativos, use Google Cloud
produtos como o Cloud Build e o
Cloud Deploy. Também é possível usar ferramentas de terceiros ou sua
própria cadeia de ferramentas.
Para trabalhar com o Infra Manager, você precisa conhecer o Terraform.
Para saber mais sobre o Terraform, comece
com o artigo da HashiCorp
O que é o Terraform?.
O Infra Manager permite usar a IaC para gerenciar o ciclo de vida dos
recursosGoogle Cloud :
O Terraform é definido de forma declarativa em uma
configuração do Terraform. Isso significa
que a configuração descreve o estado final da sua infraestrutura.
É possível fazer a versão da configuração do Terraform em um repositório do Git ou
em um
bucket do Cloud Storage.
Use o Controle de versão de objeto para criar versões de configurações em um bucket de armazenamento.
Use o Infra Manager para atualizar a implantação da infraestrutura
com revisões. Para cada revisão, o Infra Manager
armazena o seguinte:
Registros
A configuração usada para fazer a revisão
A lista de recursos do Google Cloud criados pela revisão
O arquivo de estado criado como parte de cada implantação e revisão
É possível armazenar a configuração do Terraform em um bucket do Cloud Storage, em um repositório Git ou na máquina local.
Ao usar o Infra Manager para implantar recursos de uma configuração do Terraform, você cria uma implantação. Para criar uma implantação,
o Infra Manager:
Valida a solicitação. Por exemplo, ele garante que você especificou o local da configuração do Terraform no comando.
Cria um job do Cloud Build usando uma imagem de contêiner. Esta imagem é
de propriedade e mantida por Google Cloud. Consulte
Ambiente de execução para saber mais sobre o
ambiente do Cloud Build. O job do Cloud Build automatiza as seguintes tarefas:
Faz o download do módulo do Terraform do bucket de armazenamento ou do repositório
Git.
Inicializa o Terraform (terraform init).
Valida a configuração do Terraform (terraform validate).
Ativa a configuração (terraform apply ou terraform destroy
se você estiver excluindo uma implantação)
Transmite os registros do Cloud Build para um bucket de armazenamento criado pelo Infra Manager.
Se a implantação falhar, o Infra Manager vai tentar novamente as operações terraform init ou terraform apply automaticamente em determinados cenários, como falhas com interrupções de rede intermitentes. Essas novas tentativas são realizadas um número limitado de vezes.
Cria um bucket do Cloud Storage e armazena metadados sobre a
implantação. Para mais informações sobre a implantação e os metadados, consulte
Visão geral da implantação e da revisão.
Quando a implantação for concluída, os recursos Google Cloud serão
provisionados conforme descrito na configuração.
É possível consultar a implantação do Infra Manager para:
status da implantação
A lista de recursos implantados como parte da implantação.
Detalhes sobre recursos individuais que fazem parte de uma implantação.
Ambiente de execução
O ambiente de execução do Infra Manager é um ambiente efémero do Cloud Build.
O Infra Manager executa comandos do Terraform nesse
ambiente do Cloud Build e, em seguida, o ambiente é descartado.
O sistema operacional específico, o software disponível e outros detalhes de configuração
do ambiente do Cloud Build são detalhes de implementação interna
do Infra Manager e podem mudar a qualquer momento.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 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)."]]
