Aprovisione recursos do Artifact Registry com o Terraform
O HashiCorp Terraform é uma ferramenta de infraestrutura como código (IaC) que lhe permite
aprovisionar e gerir a infraestrutura na nuvem. O Terraform oferece plug-ins denominados
fornecedores que lhe permitem interagir com fornecedores de nuvem e outras APIs. Pode
usar o fornecedor do Terraform para Trusted Cloud aprovisionar e gerir
Trusted Cloud by S3NS recursos, incluindo o Artifact Registry.
Esta página apresenta a utilização do Terraform com o Artifact Registry, incluindo uma introdução ao funcionamento do Terraform e alguns recursos para ajudar a começar a usar o Terraform com o Trusted Cloud. Também encontra links para documentos de referência do Terraform para o
Artifact Registry, exemplos de código e guias para usar o Terraform para aprovisionar
recursos do Artifact Registry.
Para obter instruções sobre como começar a usar o Terraform para o Trusted Cloud, consulte o artigo
Instale e configure o Terraform ou o
início rápido do Terraform para o Trusted Cloud .
O Terraform tem uma sintaxe declarativa e orientada para a configuração, que pode usar para descrever a infraestrutura que quer aprovisionar no seu Trusted Cloud projeto. Depois de criar esta configuração num ou mais ficheiros de configuração do Terraform, pode usar a CLI do Terraform para aplicar esta configuração aos seus recursos do Artifact Registry.
Os passos seguintes explicam como funciona o Terraform:
- Descreve a infraestrutura que quer aprovisionar num ficheiro de configuração do Terraform. Não precisa de escrever código que descreva como
aprovisionar a infraestrutura. O Terraform aprovisiona a infraestrutura por si.
- Executa o comando
terraform plan, que avalia a sua configuração e
gera um plano de execução. Pode rever o plano e fazer alterações conforme
necessário.
-
Executa o comando terraform apply, que realiza as seguintes ações:
- Aprovisiona a sua infraestrutura com base no seu plano de execução invocando as APIs do Artifact Registry correspondentes em segundo plano.
- Cria um ficheiro de estado do Terraform, que é um ficheiro JSON que mapeia os recursos
no seu ficheiro de configuração para os recursos na infraestrutura do mundo real. O Terraform usa este ficheiro para manter um registo do estado mais recente da sua infraestrutura e para determinar quando criar, atualizar e destruir recursos.
-
Quando executa terraform apply, o Terraform usa o mapeamento no ficheiro de estado para comparar a infraestrutura existente com o código e fazer atualizações conforme necessário:
- Se um objeto de recurso estiver definido no ficheiro de configuração, mas não existir no ficheiro de estado, o Terraform cria-o.
- Se um objeto de recurso existir no ficheiro de estado, mas tiver uma configuração diferente da do ficheiro de configuração, o Terraform atualiza o recurso para corresponder ao ficheiro de configuração.
- Se um objeto de recurso no ficheiro de estado corresponder ao seu ficheiro de configuração,
o Terraform deixa o recurso inalterado.
Recursos do Terraform para o Artifact Registry
Os recursos são os elementos fundamentais na linguagem Terraform. Cada bloco de recursos descreve um ou mais objetos de infraestrutura, como redes virtuais ou instâncias de computação.
A tabela seguinte apresenta os recursos do Terraform disponíveis para o
Artifact Registry:
Guias baseados no Terraform para o Artifact Registry
A tabela seguinte lista os guias de instruções e os tutoriais baseados no Terraform para o
Artifact Registry:
Módulos e projetos do Terraform para o Artifact Registry
Os módulos e os esquemas ajudam a automatizar o aprovisionamento e a gestão de Trusted Cloud recursos em grande escala. Um módulo é um conjunto reutilizável de ficheiros de configuração do Terraform que cria uma abstração lógica dos recursos do Terraform. Um projeto é um pacote de módulos implementáveis e reutilizáveis, e uma política que implementa e documenta uma solução específica.
A tabela seguinte apresenta módulos e esquemas relacionados com o
Artifact Registry:
| Módulo ou planta |
Detalhes |
| artifact-registry |
Crie e faça a gestão de repositórios do Artifact Registry |
| gcloud |
Executa Trusted Cloud by S3NS comandos da CLI no Terraform |
O que se segue?
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-21 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003eTerraform is an infrastructure-as-code tool used to provision and manage cloud infrastructure, including Google Cloud resources like Artifact Registry, through its declarative configuration files and providers.\u003c/p\u003e\n"],["\u003cp\u003eUsing the Terraform CLI, you describe your desired infrastructure in configuration files, then use \u003ccode\u003eterraform plan\u003c/code\u003e to review an execution plan and \u003ccode\u003eterraform apply\u003c/code\u003e to provision resources and manage their state.\u003c/p\u003e\n"],["\u003cp\u003eTerraform's state file maintains a record of your infrastructure's current state, enabling it to create, update, or leave resources unchanged by comparing the existing infrastructure to your configuration code.\u003c/p\u003e\n"],["\u003cp\u003eTerraform resources for Artifact Registry include managing repositories, IAM, and VPC-SC configurations, while data sources include information on Docker images and repository IAM policies.\u003c/p\u003e\n"],["\u003cp\u003eTerraform modules and blueprints for Artifact Registry provide reusable sets of configurations to automate the provisioning and management of Google Cloud resources, allowing for standardized and efficient infrastructure deployment.\u003c/p\u003e\n"]]],[],null,["# Provision Artifact Registry resources with Terraform\n\nHashiCorp Terraform is an infrastructure-as-code (IaC) tool that lets you\nprovision and manage cloud infrastructure. Terraform provides plugins called\n*providers* that let you interact with cloud providers and other APIs. You can\nuse the *Terraform provider for Google Cloud* to provision and manage\nGoogle Cloud resources, including Artifact Registry.\n\nThis page introduces you to using Terraform with Artifact Registry, including an\nintroduction to how Terraform works and some resources to help you get started using\nTerraform with Google Cloud. You'll also find links to Terraform reference docs for\nArtifact Registry, code examples, and guides for using Terraform to provision\nArtifact Registry resources.\n\nFor instructions on how to get started with Terraform for Google Cloud, see\n[Install and configure Terraform](/docs/terraform/install-configure-terraform) or the\n[Terraform for Google Cloud quickstart](/docs/terraform/create-vm-instance).\n\nHow Terraform works\n-------------------\n\nTerraform has a declarative and configuration-oriented syntax, which you can\nuse to describe the infrastructure that you want to provision in your\nGoogle Cloud project. After you author this configuration in one or more\nTerraform configuration files, you can use the Terraform CLI to apply this\nconfiguration to your Artifact Registry resources.\n\nThe following steps explain how Terraform works:\n\n1. You describe the infrastructure you want to provision in a *Terraform\n configuration file*. You don't need to write code describing how to provision the infrastructure. Terraform provisions the infrastructure for you.\n2. You run the `terraform plan` command, which evaluates your configuration and generates an execution plan. You can review the plan and make changes as needed.\n3. You run the `terraform apply` command, which performs the following\n actions:\n\n 1. It provisions your infrastructure based on your execution plan by invoking the corresponding Artifact Registry APIs in the background.\n 2. It creates a *Terraform state file*, which is a JSON file that maps the resources in your configuration file to the resources in the real-world infrastructure. Terraform uses this file to keep a record of the most recent state of your infrastructure, and to determine when to create, update, and destroy resources.\n 3. When you run `terraform apply`, Terraform uses the mapping in\n the state file to compare the existing infrastructure to the code, and make\n updates as necessary:\n\n - If a resource object is defined in the configuration file, but doesn't exist in the state file, Terraform creates it.\n - If a resource object exists in the state file, but has a different configuration from your configuration file, Terraform updates the resource to match your configuration file.\n - If a resource object in the state file matches your configuration file, Terraform leaves the resource unchanged.\n\nTerraform resources for Artifact Registry\n-----------------------------------------\n\n*Resources* are the fundamental elements in the Terraform language. Each\nresource block describes one or more infrastructure objects, such as virtual\nnetworks or compute instances.\n\nThe following table lists the Terraform resources available for\nArtifact Registry:\n\n\n\u003cbr /\u003e\n\nTerraform-based guides for Artifact Registry\n--------------------------------------------\n\nThe following table lists Terraform-based how-to guides and tutorials for\nArtifact Registry:\n\n\n\u003cbr /\u003e\n\nTerraform modules and blueprints for Artifact Registry\n------------------------------------------------------\n\nModules and blueprints help you automate provisioning and managing of\nGoogle Cloud resources at scale. A *module* is a\nreusable set of Terraform configuration files that creates a logical abstraction\nof Terraform resources. A *blueprint* is a package of deployable and reusable\nmodules, and a policy that implements and documents a specific solution.\n\nThe following table lists modules and blueprints related to\nArtifact Registry:\n\n\n\u003cbr /\u003e\n\nWhat's next\n-----------\n\n- [Terraform code samples for Artifact Registry](/docs/samples?language=terraform)\n- [Terraform on Google Cloud documentation](/docs/terraform)\n- [Google Cloud provider documentation in HashiCorp](https://registry.terraform.io/providers/hashicorp/google/latest/docs)\n- [Infrastructure as code for Google Cloud](/docs/terraform/iac-overview)"]]
