백업에서 상태 복구(Recover state from backup) 개요

이 문서는 장애 상황, 예를 들어 다른 상태(state) 조작 작업을 수행하다 실수한 경우에 백업에서 Terraform 상태를 복구하는 방법에 대한 개요를 설명해요. 상태 파일은 인프라의 핵심 정보를 담고 있기 때문에, 문제가 생겼을 때 안전하게 복구하는 절차를 미리 알아두면 좋아요.

출처: 문서

본문

작업 흐름 (Workflow)

상태를 복구하는 과정은 크게 세 단계로 나눌 수 있어요.

Terraform 잠금 해제 (Unlock Terraform)

terraform apply나 다른 프로세스가 Terraform이 상태 백엔드에 대한 잠금을 해제하기 전에 예기치 않게 종료되었을 때, 잠금을 해제해야 할 수 있어요. Terraform 잠금 해제는 두 프로세스가 동시에 상태를 수정하는 것을 방지하는 보호 장치를 무시하는 작업이에요. 잠금이 걸린 원인을 파악하기 전에는 잠금을 해제하는 것을 권장하지 않아요.

추가 정보는 terraform force-unlock 명령 문서를 참고해 주세요.

상태 데이터 읽기 (Read state data)

terraform state pull 명령을 실행해서 구성된 백엔드(backend)에서 상태 파일을 읽어와요.

상태 데이터 쓰기 (Write state data)

terraform state push 명령을 실행해서 구성된 백엔드에 상태 파일을 써요.

이 세 단계를 거치면 백업해 둔 상태를 다시 백엔드에 반영해서 인프라 관리를 이어갈 수 있어요. 상태를 복구할 때는 반드시 올바른 백업을 대상으로, 잠금 상태를 확인한 뒤 신중하게 진행해야 해요.

더 알아보기 (Learn more)

terraform force-unlock 명령
terraform state pull / state push 명령
terraform state 명령 개요