terraform stacks configuration fetch 명령

terraform stacks configuration fetch 명령

terraform stacks configuration fetch 명령은 VCS(버전 관리 시스템)에서 최신 Stack 구성을 가져오는 명령이에요. VCS 저장소에 연결된 Stack의 구성을 원격에서 최신 상태로 반영하고 싶을 때 사용해요.

출처: 문서

본문

사용법 (Usage)

$ terraform stacks <global-stacks-flags> configuration fetch <options>

설명 (Description)

terraform stacks configuration fetch 명령은 VCS 저장소에 연결된 Stack에 대해 버전 관리 시스템(VCS)에서 최신 구성을 가져와요. 대상 Stack은 Stack ID를 직접 제공하거나, 조직 이름·프로젝트 이름·Stack 이름 조합을 지정해서 식별할 수 있어요.

옵션 (Options)

  • -organization-name: 대상 조직의 이름.
    • -stack-id를 사용할 때는 선택 사항이고, 이름 기반 타게팅을 사용할 때는 필수예요.
    • 문자열 데이터 타입.
    • 제공되면 환경 변수 TF_STACKS_ORGANIZATION_NAME을 덮어씀.
  • -project-name: 대상 프로젝트의 이름.
    • -stack-id를 사용할 때는 선택 사항이고, 이름 기반 타게팅을 사용할 때는 필수예요.
    • 문자열 데이터 타입.
    • 제공되면 환경 변수 TF_STACKS_PROJECT_NAME을 덮어씀.
  • -stack-name: 대상 Stack의 이름.
    • -stack-id를 사용할 때는 선택 사항이고, 이름 기반 타게팅을 사용할 때는 필수예요.
    • 문자열 데이터 타입.
    • 제공되면 환경 변수 TF_STACKS_STACK_NAME을 덮어씀.
  • -stack-id: 구성으로 가져올 Stack의 ID.
    • 선택 사항 (하지만 -stack-name을 사용하지 않으면 필수예요).
    • 문자열 데이터 타입.
    • 두 값이 모두 제공되면 -stack-name보다 우선함.
  • -json: JSON 형식으로 결과를 출력함.
    • 선택 사항.
    • Boolean 플래그.
    • 기본값은 false (사람이 읽기 좋은 출력).

예시 (Examples)

다음 명령은 조직, 프로젝트, Stack 이름을 사용해서 Stack의 구성을 가져와요.

$ terraform stacks configuration fetch -organization-name my-org -project-name my-project -stack-name my-stack

다음 명령은 Stack ID를 사용해서 Stack의 구성을 가져와요.

$ terraform stacks configuration fetch -stack-id stack-abc123def456

다음 명령은 구성을 가져오고 결과를 JSON 형식으로 출력해요.

$ terraform stacks configuration fetch -stack-id stack-abc123def456 -json

전역 플래그 (Global flags)

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

더 알아보기 (Learn more)

  • terraform stacks configuration 명령
  • terraform stacks configuration upload 명령
  • Terraform Stacks CLI 참조 문서