Terraform 운영 함정 해결 스킬

무엇을 해주나

실제 인프라 배포 중 발생한 장애 사례를 정확한 에러 메시지 → 근본 원인 → 복사해서 붙이는 수정 코드 형태로 제공합니다. Claude Code가 Terraform 코드를 작성하거나 terraform apply 실패를 디버깅할 때 이 지식을 자동으로 참조합니다.

주요 커버 범위:

• Provisioner 함정: docker: not found(cloud-init 미완료), local-exec rsync 연결 끊김, cloud-init이 debconf 프롬프트에서 멈추는 문제, set -e 때문에 진단 로그가 사라지는 문제
• 컨테이너 장애: 볼륨 권한(EACCES, uid 1001), DB 미생성/마이그레이션 누락으로 인한 Restarting 루프, .env 대신 셸 변수로 build arg를 넘겨 실패하는 문제
• TLS/도메인: Caddy DNS-01 ACME에 Global API Key 대신 API Token(cfut_)이 필요한 이유, Caddyfile·compose의 하드코딩 도메인을 {$VAR} / ${VAR:?required}로 파라미터화
• 다중 환경 분리: 전역 유일 리소스 충돌 표, 같은 존에 A 레코드 중복 생성으로 트래픽 50%가 잘못된 인스턴스로 가는 함정, 스냅샷 교차 오염
• 사전 검증 & 제로부터 배포: terraform apply 전에 로컬에서 잡아내는 7가지 체크리스트

이런 분께 추천

• Terraform provisioner(remote-exec/local-exec/file)로 원격 호스트를 직접 구성하는 엔지니어
• staging/production 등 여러 환경을 같은 코드베이스로 운영하려는 팀
• Docker Compose + Caddy 게이트웨이 + Cloudflare DNS 조합으로 서비스를 올리는 인프라 담당자
• 배포 → 실패 발견 → 수정 → 재배포 루프를 줄이고 싶은 DevOps

활용 예시

1. terraform apply 중 remote-exec에서 docker: not found가 났을 때 → Claude가 cloud-init status --wait 게이트를 넣은 provisioner 블록을 제안합니다.
2. staging 환경만 TLS 인증서 발급이 실패할 때 → Caddyfile에 프로덕션 도메인이 하드코딩됐는지, Cloudflare 자격증명이 API Token 형식인지 순서대로 점검합니다.
3. 두 번째 환경을 새로 만들기 전 → SSH 키 이름, 로그 프로젝트, DNS 레코드 등 전역 유일 리소스를 ${env}- 접두사로 바꾸도록 .tf 파일을 훑어줍니다.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 terraform-skill 폴더를 내 ~/.claude/skills/terraform-skill/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.