terraform stacks migrate validate-manifest 명령
terraform stacks migrate validate-manifest 명령
terraform stacks migrate validate-manifest 명령은 마이그레이트 매니페스트(migrate manifest)와 기대되는 파일 시스템 레이아웃을 검증하는 명령이에요. 매니페스트를 준비한 뒤, 상태를 번역하기 전에 이 명령으로 유효성을 먼저 확인해요.
출처: 문서
본문
실험적 기능:
terraform stacks migrate명령 그룹은 실험적이며 기본적으로 비활성화되어 있어요. 이 명령들을 활성화하려면TF_STACKS_MIGRATE_EXPERIMENTAL=true를 설정해야 해요. 프로덕션 리소스에는 이 명령들을 사용하지 마세요.
사용법 (Usage)
$ TF_STACKS_MIGRATE_EXPERIMENTAL=true terraform stacks <global-stacks-flags> migrate validate-manifest <options>
설명 (Description)
terraform stacks migrate validate-manifest 명령은 마이그레이트 매니페스트를 읽고, 그 스키마를 검증하며, 매니페스트가 참조하는 파일과 디렉터리를 확인해요. 매니페스트를 준비한 뒤 상태를 번역하기 전에 이 명령을 사용해요.
매니페스트 경로는 절대 경로가 아닌 한 매니페스트가 들어 있는 디렉터리 기준으로 해석돼요.
이 명령은 다음 조건들이 참인지 검증해요.
- 매니페스트가 버전
1을 사용함. - 매니페스트가 최소 하나의 배포를 포함함.
- 매니페스트가 최상위
source_configuration과stacks_configuration값을 설정함. - 각 배포가 이름, inputs 배열,
state.tfstate경로,state.tfstackstate경로를 가짐. - 각 배포 이름이 고유함.
- 워크스페이스 ID가 있다면 고유함.
- 각 배포 입력 키가 배포당 한 번만 나타남.
- 모든 배포가 동일한 입력 키를 동일한 민감도 설정으로 사용함.
- 소스 구성 디렉터리가 존재하고 비어 있지 않음.
- Stack 구성 디렉터리와 상태 산출물 디렉터리가 존재하고 쓰기 가능함.
- 각
state.tfstate경로가 Terraform v0.12+로 생성된 읽기 가능한 Terraform 상태 파일을 가리킴.
옵션 (Options)
-migrate-manifest: 검증할 마이그레이트 매니페스트의 경로.- 선택 사항.
- 문자열.
- 기본값:
migrate-manifest.json.
-json: 기본적인 사람이 읽기 좋은 텍스트 형식 대신 JSON 형식으로 결과와 진단을 출력함.- 선택 사항.
- Boolean 플래그.
- 기본값:
false.
예시 (Examples)
다음 명령은 기본 마이그레이트 매니페스트를 검증해요.
$ TF_STACKS_MIGRATE_EXPERIMENTAL=true terraform stacks migrate validate-manifest
다음 명령은 사용자 지정 경로의 매니페스트를 검증해요.
$ TF_STACKS_MIGRATE_EXPERIMENTAL=true terraform stacks migrate validate-manifest \
-migrate-manifest=./migration/migrate-manifest.json
다음 명령은 매니페스트를 검증하고 결과를 JSON 형식으로 반환해요.
$ TF_STACKS_MIGRATE_EXPERIMENTAL=true terraform stacks migrate validate-manifest \
-migrate-manifest=./migration/migrate-manifest.json \
-json
전역 플래그 (Global flags)
모든 명령에서 공통으로 사용할 수 있는 플래그에 대한 정보는 Global flags reference 문서를 참고해 주세요.
더 알아보기 (Learn more)
- HCP Terraform 워크스페이스를 Terraform Stacks로 마이그레이션하기
- terraform stacks migrate 명령
- terraform stacks migrate prepare-manifest 명령
- Terraform Stacks CLI 참조 문서