terraform stacks migrate translate-config 명령

terraform stacks migrate translate-config 명령은 전통적인 Terraform 루트 모듈을 Terraform Stacks 구성으로 변환하는 명령이에요. 마이그레이트 매니페스트를 읽고 Stack 구성 레이아웃을 생성해 줘요.

출처: 문서

본문

실험적 기능: terraform stacks migrate 명령 그룹은 실험적이며 기본적으로 비활성화되어 있어요. 이 명령들을 활성화하려면 TF_STACKS_MIGRATE_EXPERIMENTAL=true를 설정해야 해요. 프로덕션 리소스에는 이 명령들을 사용하지 마세요.

사용법 (Usage)

$ TF_STACKS_MIGRATE_EXPERIMENTAL=true terraform stacks <global-stacks-flags> migrate translate-config <options>

설명 (Description)

terraform stacks migrate translate-config 명령은 마이그레이트 매니페스트를 읽고, 전통적인 Terraform 루트 모듈을 검사한 뒤, 매니페스트의 stacks_configuration 경로에 Terraform Stacks 구성 레이아웃을 작성해요.

생성된 레이아웃은 컴포넌트 구성, 배포 구성, 그리고 소스 모듈의 복사본을 포함해요. 이 명령은 변환 전에 매니페스트를 검증해서, 파일을 작성하기 전에 매니페스트나 파일 시스템 오류를 보고할 수 있어요. 매니페스트와 기대되는 파일 시스템 레이아웃만 검증하려면 validate-manifest를 사용해요.

옵션 (Options)

-migrate-manifest: 마이그레이트 매니페스트의 경로.
- 선택 사항.
- 문자열.
- 기본값: migrate-manifest.json.
-root-component-name: 생성된 Terraform Stacks 구성에서 루트 컴포넌트에 사용할 이름.
- 선택 사항.
- 문자열.
- 기본값: workspace.
-json: 기본적인 사람이 읽기 좋은 텍스트 형식 대신 JSON 형식으로 결과를 출력함.
- 선택 사항.
- Boolean 플래그.
- 기본값: false.

예시 (Examples)

다음 명령은 기본 마이그레이트 매니페스트에서 Terraform Stacks 구성을 생성해요.

$ TF_STACKS_MIGRATE_EXPERIMENTAL=true terraform stacks migrate translate-config

다음 명령은 사용자 지정 경로의 매니페스트에서 Terraform Stacks 구성을 생성해요.

$ TF_STACKS_MIGRATE_EXPERIMENTAL=true terraform stacks migrate translate-config \
  -migrate-manifest=./migration/migrate-manifest.json

다음 명령은 생성된 구성에서 사용자 지정 루트 컴포넌트 이름을 사용해요.

$ TF_STACKS_MIGRATE_EXPERIMENTAL=true terraform stacks migrate translate-config \
  -root-component-name=application

전역 플래그 (Global flags)

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

더 알아보기 (Learn more)

HCP Terraform 워크스페이스를 Terraform Stacks로 마이그레이션하기
terraform stacks migrate validate-manifest 명령
terraform stacks migrate 명령
terraform stacks migrate translate-state 명령