feat(infra): 운영 DB·오브젝트 백업 스크립트 + 일 1회 cron

[i3months]

요약

점검 결과 백업이 하나도 없었습니다. 스크립트를 추가하고 운영에 설치·검증했습니다.

발견

확인 항목	결과
systemd 타이머	apt 업그레이드뿐
crontab (사용자·root)	비어 있음
덤프 파일	없음 (6월 git patch 하나뿐)

데이터가 단일 도커 볼륨에만 있었습니다 — PostgreSQL 13MB(사용자 5명, 세션 100건, 메시지 451건, 피드백 76건, 임베딩 57건), MinIO 246MB(이력서·음성·TTS·분석 원문).

배포 워크플로가 볼륨을 건드리진 않습니다(up -d --build + image prune뿐). 다만 infra/CLAUDE.md 가 초기화 절차로 docker compose down -v 를 안내하고, 같은 문서가 그걸 안티패턴으로 경고까지 합니다 — 위험을 알면서 안전망이 없는 상태였습니다.

변경 내용

infra/backup/backup.sh — pg_dump -Fc + MinIO 볼륨 tar.gz, 보존 14일, ~/backups 저장.

설계에서 신경 쓴 세 가지 (전부 오늘 겪은 함정의 재발 방지입니다):

1. 받은 즉시 검증합니다. pg_restore --list 로 복원 가능한 형식인지 + 테이블 데이터가 실제로 들어 있는지 확인하고, 아니면 실패로 끝냅니다. 0바이트나 깨진 파일을 성공으로 세면 "백업이 있다"는 착각만 남습니다.

2. MinIO tar 를 --user 로 돌립니다. 없이 돌리면 결과물이 root 소유가 되고, 보존 삭제(find -delete)가 stackup 유저 권한으로 조용히 실패해 아카이브가 무한정 쌓입니다. 시험 실행에서 실제로 root 소유로 나오는 걸 확인하고 고쳤습니다.

3. LAST_SUCCESS 마커를 남깁니다. cron 출력은 아무도 보지 않습니다. 백업이 멈춘 것과 정상인 것을 구분할 유일한 단서입니다.

검증 — 실제로 복원해봤습니다

임시 DB 로 받아 원본과 대조했습니다:

복원된 테이블 수: 20
  users                  원본 5      복원 5      OK
  interview_sessions     원본 100    복원 100    OK
  interview_messages     원본 451    복원 451    OK
  session_feedbacks      원본 76     복원 76     OK
  document_embeddings    원본 57     복원 57     OK
  analyzed_documents     원본 35     복원 35     OK
  resumes                원본 18     복원 18     OK
==> 복원 검증 통과

복원해보지 않은 백업은 백업이 아니라고 봐서 여기까지 했습니다.

운영 반영 상태 (이미 적용됨)

• ~/stackup/infra/backup/backup.sh 설치
• crontab: 0 4 * * * ... >> ~/backups/backup.log 2>&1
• 첫 백업 생성 완료 (pg 688K + minio 246M, LAST_SUCCESS 기록됨)

이 PR 이 머지되면 deploy 의 rsync 가 같은 내용으로 덮어써 레포와 서버가 일치합니다.

⚠️ 한계 — 이걸로 못 막는 것

같은 디스크에 저장합니다. 실수 삭제·잘못된 마이그레이션·논리적 손상은 막지만 디스크·호스트 장애는 못 막습니다. 원격 복제(S3 또는 다른 호스트 rsync)가 다음 단계입니다.

그리고 스크립트가 실패하면 cron 은 조용합니다. LAST_SUCCESS 를 보는 사람이 없으면 결국 같은 함정이라, 헬스체크에 마커 신선도를 넣는 것을 후속으로 제안합니다(/api/system/health 에 backup 컴포넌트 추가). README 에 둘 다 명시했습니다.

리뷰어 체크포인트

• 실행 시각 04:00 KST 가 적절한지 (백업 중 pg_dump 가 짧게 락을 잡습니다 — 13MB 라 1초 미만)
• 보존 14일 / 저장 위치 ~/backups 가 적절한지
• RabbitMQ 볼륨은 제외했습니다(큐 재선언 + 메시지 휘발성). 동의하시는지

🤖 Generated with Claude Code