terraform stacks fmt 레퍼런스

terraform stacks fmt 커맨드는 Stack의 모든 배포·컴포넌트 설정 파일을 표준(캐노니컬) 형식으로 다시 작성해요. 모든 설정 파일(.tfstack.hcl, .tfcomponent.hcl, .tfdeploy.hcl)이 갱신돼요.

출처: 문서

본문

$ terraform stacks fmt [target]

terraform stacks fmt 커맨드는 모든 Terraform Stacks 설정 파일을 표준 형식으로 다시 작성해요. 모든 설정 파일(.tfstack.hcl, .tfcomponent.hcl, .tfdeploy.hcl)이 갱신돼요.

기본적으로 fmt는 현재 디렉터리에서 Terraform Stacks 설정 파일을 검색해요. target 인자에 디렉터리를 지정하면 그 디렉터리를 대신 검색해요. 파일을 지정하면 그 파일만 처리해요. 단일 대시("-")를 지정하면 표준 입력(stdin)에서 읽어요.

내용은 Terraform 언어의 네이티브 문법이어야 해요. JSON은 지원되지 않아요.

target: 포맷할 대상 파일 또는 디렉터리. - 이 인자는 선택사항이에요.
- 데이터 타입: string (파일 경로, 디렉터리 경로, 또는 stdin을 뜻하는 "-").
- 기본값: 현재 디렉터리.

-list=true: 형식이 다른 파일을 나열하지 않아요.
- 선택사항.
- 데이터 타입: boolean.
- 기본값: true.
- stdin(-)에서 읽을 때는 항상 false이고, -check를 사용할 때는 항상 true예요.
-write=true: 소스 파일에 쓰지 않아요.
- 선택사항.
- 데이터 타입: boolean.
- 기본값: true.
- stdin(-)에서 읽거나 -check를 사용할 때는 항상 false예요.
-diff: 포맷 변경의 diff를 표시해요.
- 선택사항.
- 데이터 타입: boolean.
- 기본값: false.
-check: 입력이 포맷되어 있는지 검사해요. 모든 입력이 올바르게 포맷되었으면 종료 상태가 0이고, 그렇지 않으면 0이 아니에요.
- 선택사항.
- 데이터 타입: boolean.
- 기본값: false.
-recursive: 하위 디렉터리의 파일도 함께 처리해요. 기본적으로는 지정한 디렉터리(또는 현재 디렉터리)만 처리해요.
- 선택사항.
- 데이터 타입: boolean.
- 기본값: false.

다음 커맨드는 현재 디렉터리의 모든 설정 파일을 포맷해요:

$ terraform stacks fmt

다음 커맨드는 특정 디렉터리의 모든 설정 파일을 포맷해요:

$ terraform stacks fmt ./my-stack

다음 커맨드는 특정 파일을 포맷해요:

$ terraform stacks fmt stack.tfstack.hcl

다음 커맨드는 변경 없이 파일이 올바르게 포맷되었는지 검사해요:

$ terraform stacks fmt -check

다음 커맨드는 적용될 포맷 차이를 보여줘요:

$ terraform stacks fmt -diff

다음 커맨드는 하위 디렉터리의 파일을 재귀적으로 포맷해요:

$ terraform stacks fmt -recursive

모든 커맨드에서 사용할 수 있는 플래그에 대한 정보는 전역 플래그 레퍼런스를 참고하세요.