Terraform 및 Infrastructure Manager

Infrastructure Manager (Infra Manager)를 사용하려면 Terraform에 익숙해야 합니다. Terraform에 대해 자세히 알아보려면 Terraform이란 무엇인가요?를 참조하세요.

Infra Manager는 Terraform 구성에 정의된 인프라 리소스 및 구성을 배포합니다. 이러한 구성은 여러 파일과 디렉터리로 구성될 수 있지만 진입점은 Terraform 루트 모듈이어야 합니다.

Infra Manager는 청사진이라는 용어를 사용하여 Terraform 구성을 참조합니다.

Google Cloud에서 Terraform을 사용하는 방법에 대한 자세한 내용은 Google Cloud에서 Terraform 사용을 참조하세요.

Google Cloud용 Terraform 모듈

Google Cloud 리소스를 프로비저닝하는 모듈 집합은 Google Cloud용 Terraform 청사진 및 모듈을 참조하세요.

Google Cloud용 자체 Terraform 모듈을 만들 수도 있습니다. 자세한 내용은 모듈 만들기를 참고하세요.

지원되는 Terraform 버전

인프라 관리자는 다음 Terraform 버전을 지원합니다.

Terraform 버전 가격 책정 등급 사용 가능한 날짜 지원 중단일 지원 종료일 버전으로 자동 이전
1.2.3 무료 등급 2023년 8월 21일 2026년 1월 8일 2026년 2월 8일 1.5.7
1.3.10 무료 등급 2024년 3월 14일 미정 미정 미정
1.4.7 무료 등급 2024년 3월 14일 미정 미정 미정
1.5.7 무료 등급 2024년 3월 14일 미정 미정 미정
1.16.5 유료 2026년 11월 2일 미정 미정 미정

각 Terraform 버전에 도입된 기능에 대한 자세한 내용은 HashiCorp Terraform 문서 및 Terraform 버전을 참조하세요.

Google Cloud 콘솔에서 배포를 만들거나, 배포를 업데이트하거나, 배포를 미리 볼 때 또는 gcloud CLI에서 --tf-version-constraint 플래그를 사용하여 Infra Manager가 사용하는 Terraform 버전을 지정할 수 있습니다.

새 배포 또는 프리뷰를 만들 때 Terraform 버전을 지정하지 않으면 Infra Manager는 기본적으로 지원되는 최신 무료 등급 버전(1.5.7)을 사용합니다. 유료 버전 (예: 1.16.5)을 사용하려면 버전 제약 조건을 명시적으로 지정해야 합니다.

배포를 업데이트할 때 이후 Terraform 버전으로 업그레이드할 수 있지만 지원되는 이전 버전으로 다운그레이드할 수는 없습니다. Terraform 버전 지원 중단에 대한 자세한 내용은 Terraform 버전 관리 정책 문서를 참조하세요.

특정 배포 또는 버전을 만드는 데 사용된 Terraform 버전을 보려면 배포 세부정보 보기 및 버전 세부정보 보기를 참조하세요.

Terraform 버전 라이선스 및 가격 책정

Terraform 버전 1.5.7 이하는 Mozilla Public License (MPL 2.0)에 따라 오픈소스로 배포되며 Infra Manager 관리 수수료 없이 무료 등급에서 사용할 수 있습니다.

Terraform 버전 1.16.5은 비즈니스 소스 라이선스 (BUSL)에 따라 배포되며 Infra Manager에서 유료 버전으로 제공됩니다. 유료 Terraform 버전을 사용하면 Infra Manager에서 관리하는 리소스 수에 따라 배포 및 관리 요금이 발생합니다.

  • 무료 등급 허용량: 각 결제 계정에는 매월 최대 500개의 리소스가 무료로 제공됩니다.

  • 사용 요금: 월간 무료 등급 한도인 리소스 500개를 초과하면 유료 Terraform 버전을 사용하는 배포에서 관리하는 리소스에 리소스당 시간별로 측정되는 리소스 관리 요금이 발생합니다.

  • 미리보기는 무료: 유료 Terraform 버전 (예: 1.16.5)은 Infra Manager 배포에만 요금이 청구되며 배포 미리보기에는 요금이 청구되지 않습니다.

가격 책정에 대한 자세한 내용은 Infrastructure Manager 가격 책정을 참조하세요.

Terraform 구성 제약조건

Infrastructure Manager를 사용하여 Terraform 구성을 배포하려면 구성에 다음과 같은 제약조건이 있습니다.

Terraform 구성 값 및 민감한 정보

Terraform 구성 값에 개인 식별 정보나 민감한 정보를 포함하지 마세요.

Google Cloud 제공업체 문서에는 민감한 정보를 포함할 수 있는 구성 값이 표시됩니다.

예를 들어 google_storage_bucket_object 리소스는 content 인수를 사용하여 Cloud Storage 객체를 만들 수 있습니다. 이 인수는 Google Cloud 제공업체 문서의 google_storage_bucket_object 페이지에서 민감한 정보로 라벨이 지정됩니다.

이러한 라벨을 사용하면 Terraform 구성을 만들거나 사용하기 전에 기존 Terraform 구성을 검토할 때 도움이 됩니다.

Google Cloud 에서 클라우드 서비스의 제공 및 관리 중에 수집하거나 생성하는 개인 정보를 처리하는 방법에 대한 자세한 내용은 Google Cloud 개인정보처리방침을 참조하세요.

Google Cloud용 Terraform 제공업체 사용

원하는 경우 gcloud CLI를 사용하여Google Cloud에 Infra Manager에서 유지보수하는 Terraform 제공업체를 사용하도록 배포 및 프리뷰를 구성할 수 있습니다.

Infra Manager는 Google Cloud용 Terraform 제공업체를 지원합니다.

  • google
  • google-beta

Google Cloud용 HashiCorp 유지관리 Terraform 제공업체를 사용하려면 이 필드를 생략합니다.

Infra Manager에서 유지보수하는 Terraform 제공업체의 사용을 지정하는 방법을 알아보려면 Infrastructure Manager를 사용하여 인프라 배포, 배포 업데이트 또는 배포 미리보기를 참조하세요.

지원되는 제공업체 버전 확인

Infra Manager에서 지원하는 Google Cloud 용 Terraform 제공업체의 버전을 확인하려면 Infra Manager에서 유지보수하는 Cloud Storage 버킷에서 manifest.json를 확인합니다. 이 버킷은 배포 리전과 연결되어 있으며 다음과 같은 형식입니다.

https://storage.googleapis.com/LOCATION-im-providers/hashicorp/PROVIDER_VERSION/manifest.json

지원되는 버전의 전체 목록은 manifest.json 파일의 versions 필드에서 확인할 수 있습니다.

예를 들어 배포가 africa-south1 리전에 있고 google-beta 제공업체를 사용하는 경우 https://storage.googleapis.com/africa-south1-im-providers/hashicorp/google-beta/manifest.json으로 이동하여 사용 가능한 리전을 확인합니다.

다음 단계