Terraform 및 Infrastructure Manager

인프라 관리자 (Infra Manager)를 사용하려면 Terraform에 대해 잘 알고 있어야 합니다. Terraform에 대해 자세히 알아보려면 Terraform이란 무엇인가요?를 참고하세요.

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

인프라 관리자는 Terraform 구성을 지칭할 때 청사진이라는 용어를 사용합니다.

Google Cloud에서 Terraform에 대해 자세히 알아보려면 Google Cloud에서 Terraform을 참고하세요.

Google Cloud용 Terraform 모듈

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

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

지원되는 Terraform 버전

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

• Terraform 버전 1.2.3
• Terraform 버전 1.3.10
• Terraform 버전 1.4.7
• Terraform 버전 1.5.7

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

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

배포를 업데이트할 때 Terraform 버전을 최신 버전의 Terraform으로 변경할 수 있습니다. 지원되는 이전 버전의 Terraform으로 변경할 수 없습니다.

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

Terraform 구성에 대한 제약 조건

인프라 관리자를 사용하여 Terraform 구성을 배포하려면 구성에 다음 제약 조건이 있어야 합니다.

• Terraform 구성 값에 개인 정보나 민감한 정보를 포함하지 마세요. 자세한 내용은 Terraform 구성 값 및 민감한 데이터 섹션을 참고하세요.
• 유효한 Terraform 루트 모듈을 제공해야 합니다. Terraform의 템플릿 또는 생성은 지원되지 않습니다.
• 구성에는 지원되는 Terraform 버전으로 실행할 수 있는 내용이 포함되어야 합니다.
• 백엔드 블록은 정의하면 안 됩니다.
• 프로비저너 사용은 권장되지 않습니다. 가능하면 다른 해결 방법을 사용하세요. 프로비저너에 관한 자세한 내용은 프로비저너는 최후의 수단을 참고하세요. 프로비저너를 사용하는 경우 Infra Manager 런타임 환경은 언제든지 변경될 수 있습니다.

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 제공업체 사용

Google Cloud용으로 유지관리되는 Terraform 제공업체를 사용하도록 배포 및 미리보기를 구성할 수 있습니다.

이 선택적 필드를 사용하면 인프라 관리자가 유지관리하는 Terraform 제공자를 사용하여 배포 또는 배포 미리보기를 만들거나 업데이트할 수 있습니다. gcloud CLI를 사용하여 Terraform 제공업체를 지정할 수 있습니다.

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

• google
• google-beta

HashiCorp에서 유지관리하는 Google Cloud용 Terraform 제공업체를 사용하려면 이 필드를 생략하세요.

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

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

Infra Manager에서 지원하는 Terraform 제공업체 버전을 확인하려면 Infra Manager에서 유지관리하는 Cloud Storage 버킷의 manifest.json을 다음 형식으로 확인해야 합니다. Google Cloud

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으로 이동하여 사용 가능한 리전을 확인합니다.

다음 단계

• Infrastructure Manager에 대해 자세히 알아보세요.
• 배포를 만듭니다.
• 배포 업데이트
• 배포 상태 보기
• 배포 삭제