이 페이지의 일부 또는 모든 정보는 Trusted Cloud by S3NS에 적용되지 않을 수 있습니다.
Terraform으로 Artifact Registry 리소스 프로비저닝
HashiCorp Terraform은 클라우드 인프라를 프로비저닝하고 관리할 수 있게 해주는 코드형 인프라(IaC) 도구입니다. Terraform은 클라우드 제공업체 및 기타 API와 상호작용할 수 있는 제공업체라는 플러그인을 제공합니다. Trusted Cloud용 Terraform 제공업체를 사용하여 Artifact Registry를 비롯한 Trusted Cloud by S3NS 리소스를 프로비저닝하고 관리할 수 있습니다.
이 페이지에서는 Terraform 작동 방식에 관한 소개와 Trusted Cloud에서 Terraform을 사용하기 시작하는 데 도움이 되는 몇 가지 리소스를 포함하여 Artifact Registry에서 Terraform을 사용하는 방법을 소개합니다. Artifact Registry용 Terraform 참조 문서, 코드 예시, Terraform을 사용하여 Artifact Registry 리소스를 프로비저닝하는 방법에 대한 링크도 확인할 수 있습니다.
Trusted Cloud용 Terraform을 시작하는 방법에 관한 안내는 Terraform 설치 및 구성 또는 Trusted Cloud 용 Terraform 빠른 시작을 참고하세요.
Terraform에는 구성 중심의 선언적인 구문이 있으며, 이 구문을 사용하여 Trusted Cloud 프로젝트에서 프로비저닝하려는 인프라를 설명할 수 있습니다. Terraform 구성 파일 하나 이상에서 이 구성을 작성한 후 Terraform CLI를 사용하여 이 구성을 Artifact Registry 리소스에 적용할 수 있습니다.
다음 단계에서는 Terraform의 작동 방식을 설명합니다.
- Terraform 구성 파일에서 프로비저닝할 인프라를 설명합니다. 인프라를 프로비저닝하는 방법을 설명하는 코드를 작성할 필요가 없습니다. Terraform이 인프라를 자동으로 프로비저닝합니다.
terraform plan
명령어를 실행합니다. 이 명령어는 구성을 평가하고 실행 계획을 생성합니다. 계획을 검토하고 필요에 따라 변경할 수 있습니다.
-
terraform apply
명령어를 실행하여 다음 작업을 수행합니다.
- 백그라운드에서 해당 Artifact Registry API를 호출하여 실행 계획에 따라 인프라를 프로비저닝합니다.
- 구성 파일의 리소스를 실제 인프라의 리소스에 매핑하는 JSON 파일인 Terraform 상태 파일을 생성합니다. Terraform은 이 파일을 사용하여 인프라의 최신 상태를 기록하고 리소스를 생성, 업데이트, 삭제할 시기를 결정합니다.
-
terraform apply
를 실행하면 Terraform은 상태 파일의 매핑을 사용하여 기존 인프라를 코드와 비교하고 필요에 따라 업데이트합니다.
- 리소스 객체가 구성 파일에 정의되어 있지만 상태 파일에 존재하지 않는 경우 Terraform이 객체를 생성합니다.
- 리소스 객체가 상태 파일에 있지만 구성 파일의 구성과 다른 경우 Terraform은 구성 파일과 일치하도록 리소스를 업데이트합니다.
- 상태 파일의 리소스 객체가 구성 파일과 일치하면 Terraform은 리소스를 변경하지 않은 상태로 둡니다.
Artifact Registry용 Terraform 리소스
리소스는 Terraform 언어의 기본 요소입니다. 각 리소스 블록은 가상 네트워크 또는 컴퓨팅 인스턴스와 같은 하나 이상의 인프라 객체를 설명합니다.
다음 표에는 Artifact Registry에 사용할 수 있는 Terraform 리소스가 나와 있습니다.
Artifact Registry용 Terraform 기반 가이드
다음 표에는 Artifact Registry에 대한 Terraform 기반 안내 가이드 및 튜토리얼이 나와 있습니다.
Artifact Registry용 Terraform 모듈 및 청사진
모듈과 청사진은 대규모 Trusted Cloud 리소스 프로비저닝 및 관리를 자동화하는 데 유용합니다. 모듈은 Terraform 리소스의 논리적 추상화를 만드는 재사용 가능한 Terraform 구성 파일 집합입니다. 청사진은 배포 및 재사용이 가능한 모듈의 패키지이며 특정 솔루션을 구현하고 문서화하는 정책입니다.
다음 표에는 Artifact Registry와 관련된 모듈과 청사진이 나와 있습니다.
모듈 또는 청사진 |
세부정보 |
artifact-registry |
Artifact Registry 저장소 만들기 및 관리 |
gcloud |
Terraform 내에서 Trusted Cloud by S3NS CLI 명령어 실행 |
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-25(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-25(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)"]]