terraform state pull 커맨드

terraform state pull 커맨드

terraform state pull 커맨드는 원격 상태 또는 로컬 상태에서 상태 정보를 다운로드해요. 상태를 현재 위치에서 다운로드하고, 로컬에 설치된 Terraform과 호환되는 최신 상태 파일 버전으로 로컬 복사본을 업그레이드한 뒤 원시 형식을 stdout으로 출력해요.

출처: 문서

본문

사용법 (Usage)

사용법: terraform state pull [options]

이 커맨드는 상태를 현재 위치에서 다운로드하고, 로컬에 설치된 Terraform과 호환되는 최신 상태 파일 버전으로 로컬 복사본을 업그레이드한 다음, 원시 형식을 stdout으로 출력해요.

이 커맨드는 다음 옵션도 받아요:

  • -var 'NAME=VALUE' - 설정의 루트 모듈에 선언된 단일 입력 변수에 값을 설정해요. 여러 변수를 설정하려면 이 옵션을 여러 번 사용하세요. 자세한 내용은 명령줄의 입력 변수를 참고하세요.

  • -var-file=FILENAME - 설정의 루트 모듈에 선언된 많은 입력 변수.tfvars 파일의 정의를 사용해 값을 설정해요. 여러 파일의 값을 포함하려면 이 옵션을 여러 번 사용하세요. 루트 모듈의 입력 변수에 값을 설정하는 방법은 -var-var-file 옵션 외에도 여러 가지가 있어요. 자세한 내용은 입력 변수에 값 할당을 참고하세요.

이 커맨드는 상태에서 값을 읽어오는 데 유용해요(예: jq 같은 도구와 함께 사용). 또한 상태를 수동으로 수정해야 할 때도 유용해요.

이 커맨드로 원격 상태의 Terraform 버전을 검사할 수는 없어요. 출력 전에 항상 현재 Terraform 버전으로 변환되기 때문이에요.

참고: Terraform 상태 파일은 바이트 오더 마크(BOM) 없는 UTF-8 형식이어야 해요. Windows의 PowerShell에서는 Set-Content를 사용해서 파일을 자동으로 UTF-8로 인코딩하세요. 예를 들어 terraform state pull | Set-Content terraform.tfstate처럼 실행해요.

더 알아보기 (Learn more)