Terraform 상태(State) 조회 개요

Terraform은 다른 작업 없이 상태를 읽거나 갱신하기 위한 명령들을 몇 가지 제공해요. 상태 파일은 실제 인프라와 구성 사이의 연결 고리이기 때문에, 상태를 안전하게 들여다보고 싶을 때 이 명령들을 활용하면 돼요.

출처: 문서

본문

Terraform에는 상태(state)를 읽고 갱신하는 데 특화된 명령들이 있어요. 이 명령들은 인프라에 별다른 변경을 가하지 않고 상태만 다루기 때문에, 상태를 점검하거나 문제를 진단할 때 안심하고 쓸 수 있어요.

terraform state list 명령은 구성에서 Terraform이 알고 있는 모든 리소스에 대한 리소스 주소(resource address)를 보여 줘요. 부분적인 리소스 주소로 필터링도 가능해요. 예를 들어 특정 모듈 아래의 리소스만 보고 싶다면 그 경로를 인자로 넘겨서 확인할 수 있어요.
terraform state show 명령은 하나의 리소스에 대한 상세한 상태 데이터를 표시해 줘요. 개별 리소스의 속성값이 실제로 어떤 값으로 기록되어 있는지 확인할 때 사용해요.
terraform refresh 명령은 관리 중인 리소스의 실제 상태와 일치하도록 상태 데이터를 갱신해 줘요. 이 작업은 plan과 apply 과정에서는 자동으로 수행되지만, 상태를 직접 다룰 때는 수동으로 실행해 줘야 해요.

이 세 명령은 상태 파일을 직접 열어 보는 대신 커맨드라인에서 안전하게 상태를 확인하고 싶을 때 특히 유용해요. 상태 파일은 원칙적으로 직접 편집하지 않는 게 좋지만, 이렇게 공식 명령을 통해서는 조회와 갱신을 안전하게 할 수 있어요.