Terraform 버전 관리 정책

Infrastructure Manager는 특정 버전의 Terraform을 사용하여 Google Cloud 리소스를 프로비저닝하고 관리합니다. 새로운 기능을 제공하고 보안 취약점을 해결하기 위해 인프라 관리자는 사용 가능한 Terraform 버전을 주기적으로 업데이트합니다.

이 문서에서는 이러한 버전의 수명 주기를 관리하는 정책을 설명합니다. Terraform 버전 관리 정책은 Infra Manager의 새 버전을 도입하고 버전을 지원 중단하는 투명하고 예측 가능한 프로세스를 제공합니다.

정책 작동 방식

Infra Manager는 사용 가능한 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일 미정 미정 미정

표의 열은 다음을 나타냅니다.

  • Terraform 버전: Terraform 버전의 식별자입니다.
  • 사용 가능한 날짜: Infra Manager에서 버전을 사용할 수 있게 되는 날짜입니다.
  • 지원 중단일: 버전이 지원 중단될 예정인 날짜입니다. 이 날짜 이후에는 이 버전을 사용하여 배포를 만들거나 업데이트하면 경고가 생성됩니다.

  • 지원 종료일: 버전이 더 이상 지원되지 않는 날짜입니다. 이 기간은 지원 중단 후 180일 (또는 그 이상) 후에 종료됩니다.

  • 버전으로 자동 이전: 지원 종료일이 지난 후 배포가 자동으로 이전되는 버전입니다 (자동 이전을 선택한 경우).

지원되는 버전의 현재 목록과 수명 주기 날짜를 확인하려면 지원되는 Terraform 버전을 참고하세요.

버전 지원 중단 프로세스

Terraform 버전이 지원 중단일에 도달하면 지원 종료일 전에 지원 중단 기간이 시작됩니다.

버전이 지원 중단되면 다음이 적용됩니다.

  • 공개 문서가 지원 중단 날짜 및 지원 종료 날짜로 업데이트됩니다.
  • 지원 중단된 버전으로 배포 또는 미리보기를 만들거나 업데이트하면 경고가 반환됩니다. 이 경고에는 버전이 지원 중단되었으며 지원 종료 날짜가 포함되어 있습니다.

버전 지원 종료일이 지나면 버전이 오래된 것으로 표시됩니다. 지원 중단된 버전을 사용하여 새 배포를 만들려고 하면 작업이 오류와 함께 실패합니다. 지원 중단된 버전을 참조하는 기존 배포를 업데이트하려고 하면 동작은 자동 이전에 관한 조직의 정책에 따라 달라집니다.

버전 가용성 프로세스

새로운 안정화 버전의 Terraform이 출시되면 지원되는 버전 목록에 추가됩니다. 새 Terraform 버전을 Google Cloud 콘솔, gcloud CLI, API에서 사용할 수 있습니다. 버전 관리 표가 새 버전과 사용 가능 날짜로 업데이트되고 인프라 관리자 출시 노트가 생성됩니다.

자동 이전

지원되지 않는 버전을 사용하는 기존 배포를 업데이트하면 Infra Manager가 배포를 지원되는 버전으로 자동 업데이트할 수 있습니다. 이 자동 이전 기능은 조직 정책을 통해 구성하는 선택 프로세스입니다.

자동 이전 기능을 선택하지 않은 경우 지원되지 않는 버전을 사용하는 배포에서 실행하는 업데이트 작업이 실패합니다. 계속하려면 지원되는 버전을 지정하도록 배포 구성을 수동으로 수정한 후 작업을 다시 시도해야 합니다.

자동 이전 정책 구성

Google Cloud CLI를 사용하여 인프라 관리자에서 Terraform 버전의 자동 이전 정책을 구성할 수 있습니다.

자동 이전 정책을 사용 설정하려면 다음 단계를 따르세요.

gcloud infra-manager automigrationconfig enable-auto-migration --project=PROJECT_ID --location=LOCATION

자동 이전 정책을 설명하려면 다음 단계를 따르세요.

gcloud infra-manager automigrationconfig describe --project=PROJECT_ID --location=LOCATION

다음 단계