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 버전

Infra Manager는 다음 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일 미정 미정 미정

--tf-version-constraint 플래그를 사용하여 Infra Manager가 배포를 만드는 데 사용하는 Terraform 버전을 지정할 수 있습니다.

Infrastructure Manager를 사용하여 Terraform 구성을 배포하기 전에 구성에 다음 제약 조건이 있는지 확인하세요.

Terraform 버전을 지정하지 않으면 지원되는 최신 버전이 기본적으로 사용됩니다.

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

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

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를 사용하여 Infra Manager에서 유지관리하는Google Cloud용 Terraform 제공업체를 사용하도록 배포 및 미리보기를 구성할 수 있습니다.

Infra Manager는 다음과 같은 Google Cloud용 Terraform 공급자를 지원합니다.

  • google
  • google-beta

Google Cloud용 HashiCorp 유지관리 Terraform 프로바이더를 사용하려면 이 필드를 생략합니다.

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

지원되는 프로바이더 버전 확인

Infra Manager에서 지원하는 Terraform 제공업체의 버전을 확인하려면 Google Cloud 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으로 이동하여 사용 가능한 리전을 확인합니다.

다음 단계