terraform stacks providers-lock 명령

terraform stacks providers-lock 명령

terraform stacks providers-lock 명령은 현재 컴포넌트 구성에 대한 의존성 잠금 파일(dependency lock file), 즉 .terraform.lock.hcl을 생성하거나 갱신하는 명령이에요. 여러 환경과 팀 구성원 사이에서 프로바이더 버전을 일관되게 유지하는 데 핵심적인 역할을 해요.

출처: 문서

본문

사용법 (Usage)

$ terraform stacks <global-stacks-flags> providers-lock <options>

설명 (Description)

terraform stacks providers-lock 명령은 현재 컴포넌트 구성에 대한 의존성 잠금 파일(.terraform.lock.hcl)을 생성하거나 갱신해요. 이 잠금 파일은 Terraform이 사용해야 하는 프로바이더 패키지의 정확한 버전과 체크섬(checksum)을 기록해서, 서로 다른 환경과 팀 구성원 사이에 프로바이더 버전이 일관되게 유지되도록 보장해 줘요.

옵션 (Options)

  • -platform=os_arch: 패키지 체크섬을 요청할 대상 플랫폼을 선택함.
    • 선택 사항이에요.
    • os_arch 형식의 문자열 데이터 타입이에요 (예: linux_amd64, darwin_amd64).
    • 기본적으로 Terraform은 HCP Terraform 내 실행(linux_amd64)과 현재 내 컴퓨터에 적합한 패키지 체크섬을 요청해요.
    • 여러 대상 시스템의 체크섬을 포함하려면 이 옵션을 여러 번 사용해요.

예시 (Examples)

다음 명령은 현재 플랫폼과 HCP Terraform에 대한 잠금 파일을 생성하거나 갱신해요.

$ terraform stacks providers-lock

다음 명령은 여러 플랫폼에 대한 체크섬을 포함하는 잠금 파일을 생성하거나 갱신해요.

$ terraform stacks providers-lock -platform=linux_amd64 -platform=darwin_amd64 -platform=windows_amd64

여러 운영체제에서 작업하는 팀이라면, 이렇게 여러 -platform 옵션을 함께 넘겨서 모든 환경이 동일한 프로바이더 버전을 사용하도록 만들 수 있어요.

전역 플래그 (Global flags)

모든 명령에서 공통으로 사용할 수 있는 플래그에 대한 정보는 Global flags reference 문서를 참고해 주세요.

더 알아보기 (Learn more)

  • terraform stacks init 명령
  • Terraform Stacks CLI 참조 문서
  • Terraform 의존성 잠금 파일(.terraform.lock.hcl) 문서