본문 바로가기
Q&A해결2026년 4월 24일1분 읽기

Terraform 1.11 업그레이드 후 state lock이 무한 대기에 걸립니다

인
인프라엔지
조회 1016댓글 1

Terraform 1.10 → 1.11 업그레이드 후 일부 모듈에서 terraform plan이 state lock을 잡고 무한 대기합니다.

backend는 S3 + DynamoDB 표준 구성이고 권한도 그대로입니다. force-unlock으로 풀고 다시 시도해도 또 걸립니다. 1.11에서 lock 동작이 바뀐 건가요?

댓글 1

김김영삼7개월 전

1.11에서 S3 backend가 DynamoDB를 더 이상 권장하지 않고 자체 state lock(S3 conditional write)으로 전환됐습니다. 기존 DynamoDB 테이블이 새 backend의 lock을 인식 못 해서 양쪽이 충돌하는 상황입니다.

핵심 변경 (1.11 release notes)

  • S3 backend의 use_lockfile = true 옵션 추가 (기본 false → 1.12 이후 true 예정)
  • S3 conditional PutObject(If-None-Match)로 lock 구현
  • DynamoDB 테이블 의존성 제거 (deprecated, 미래 버전에서 삭제 예정)

현재 상황 진단

terraform {
backend "s3" {
bucket = "tf-state"
key = "prod/main.tfstate"
region = "ap-northeast-2"
dynamodb_table = "tf-locks" # ← 옛 방식
}
}

이 구성으로 1.11이 동작할 수는 있지만, 일부 race condition에서 DynamoDB lock과 새 lock 메커니즘이 충돌합니다.

처방 1) S3 lockfile 방식으로 마이그레이션 (권장)

terraform {
backend "s3" {
bucket = "tf-state"
key = "prod/main.tfstate"
region = "ap-northeast-2"
use_lockfile = true # ← 새 방식 활성화
# dynamodb_table는 제거 또는 유지 (전환 기간만)
}
}

마이그레이션 절차:

# 1) 모든 작업자가 작업 종료한 시점 확인
# 2) DynamoDB 테이블에서 잔존 lock 모두 삭제
aws dynamodb scan --table-name tf-locks
aws dynamodb delete-item --table-name tf-locks --key ...

# 3) S3 prefix 아래 .tflock 파일 정리
aws s3 ls s3://tf-state/prod/ | grep tflock
aws s3 rm s3://tf-state/prod/main.tfstate.tflock

# 4) backend 설정 업데이트 후 init
terraform init -reconfigure

처방 2) 기존 DynamoDB 유지하되 1.11 호환 보강

마이그레이션이 부담스러우면 그대로 가도 되지만, lock TTL 설정으로 stuck lock을 자동 해소:

# DynamoDB 테이블에 TTL 설정
aws dynamodb update-time-to-live \
--table-name tf-locks \
--time-to-live-specification "Enabled=true, AttributeName=Expires"

그리고 wrapper 스크립트로 lock에 expiration 추가하는 패턴도 가능 (단 신뢰성 떨어짐).

처방 3) 응급 — force-unlock 자동화

# 1.11에서 lock ID 형식 변경됨 — 새 형식 추출
LOCK_ID=$(terraform plan 2>&1 | grep -oP 'ID:\s*\K[a-f0-9-]+' | head -1)
terraform force-unlock -force "$LOCK_ID"

# 또는 S3 lockfile 직접 삭제 (use_lockfile 사용 시)
aws s3 rm s3://tf-state/prod/main.tfstate.tflock

실무 체크리스트

  1. 1.11+ 환경은 use_lockfile = true로 전환 권장 — DynamoDB 비용·운영 부담 모두 0
  2. 마이그레이션 전 모든 작업자 작업 종료 + 잔존 lock 정리
  3. CI 파이프라인에서 terraform plan 직전에 lockfile 존재 검사 + alert
  4. 장기적으로 OpenTofu도 함께 검토 — Terraform과 거의 동일하면서 라이센스 이슈 없음
  5. state는 항상 versioning 활성화된 S3 버킷에 저장 (Terraform 자체와 무관하게 운영 보호)

주의 — backend 변경은 신중하게

terraform init -reconfigure는 backend 설정만 바꾸고 state는 옮기지 않습니다. 만약 bucket이나 key를 바꾼다면 -migrate-state 옵션이 필요합니다 — 함께 헷갈리지 마세요.

"무한 대기"의 90%는 잔존 lock + 새 backend 호환 불일치입니다. 마이그레이션이 길게는 운영 부담을 줄이는 정답입니다.

Ctrl+Enter로 등록