terraform force-unlock 명령
terraform force-unlock 명령
terraform force-unlock 명령은 정의된 구성(configuration)에 대해 상태(state)의 잠금(lock)을 수동으로 해제하는 명령이에요. 어떤 이유로 잠금이 걸려서 plan이나 apply를 진행하지 못하는 상황에서 이 명령을 사용해서 잠금을 풀 수 있어요.
출처: 문서
본문
사용법 (Usage)
terraform force-unlock [options] LOCK_ID
현재 구성에 대한 상태의 잠금을 수동으로 해제해요. 이 명령은 인프라를 전혀 수정하지 않아요.
잠금을 해제한다고 해서 인프라 자원이 변경되지는 않아요. 이 명령은 현재 구성에 대한 상태 잠금만 제거해 줄 뿐이에요.
잠금 동작 (Lock behavior)
이 잠금의 동작 방식은 사용 중인 백엔드(backend)에 따라 달라져요.
- 로컬 상태 파일(local state file)은 다른 프로세스에서 잠금을 해제할 수 없어요.
terraform force-unlock명령은 인프라를 수정하지 않아요.
즉, 잠금을 강제로 해제하는 작업은 상태 파일에 대한 접근을 다시 허용하기 위한 것이고, 인프라 자체에는 아무 영향도 주지 않는다는 점을 꼭 기억해 두세요. 잠금을 풀 때는 반드시 올바른 LOCK_ID를 사용해야 해요.
옵션 (Options)
-force: 잠금 해제 확인을 위한 입력(확인 프롬프트)을 묻지 않음.
예를 들어 CI 환경처럼 대화형 프롬프트를 처리할 수 없는 상황에서 잠금을 해제할 때 -force 플래그를 사용하면 되고, 대화형 터미널에서는 확인을 거쳐 안전하게 해제할 수 있어요.
더 알아보기 (Learn more)
- terraform state 명령 개요
- terraform state list / state show 명령
- Terraform 백엔드(backend) 구성 문서