DB Backup

Database Backup & Restore Skill

PostgreSQL 데이터베이스를 백업하고 복원합니다.

사용법

/db-backup backup                    # Docker DB 백업
/db-backup backup --local            # 로컬 DB 백업 (localhost:5434)
/db-backup list                      # 백업 목록 조회
/db-backup restore <file>            # Docker DB로 복원
/db-backup restore <file> --server   # 서버 DB로 복원

Arguments

실행 스크립트

Docker 환경 (기본)

# 프로젝트 루트에서 실행
cd $PROJECT_ROOT

# 백업 (Docker)
python backup_db.py

# 복원 (Docker)
python restore_db.py <backup_file>

로컬/서버 환경

# backend 디렉토리에서 실행
cd $PROJECT_ROOT/backend

# 백업 (로컬 DB)
python -m scripts.db_backup --backup

# 복원 (로컬 DB)
python -m scripts.db_backup --restore <file> --target local

# 복원 (서버 DB) - SERVER_DATABASE_URL 필요
python -m scripts.db_backup --restore <file> --target server

# 목록 조회
python -m scripts.db_backup --list

환경 변수 (.env)

백업 파일 위치

backups/
├── backup_20260130_120000.sql       # 일반 백업
├── backup_20260130_120000.dump      # 압축 백업
├── edwards_backup_*.sql             # Docker 백업 (backup_db.py)
└── edwards_full_backup_*.sql.gz     # 전체 백업

워크플로우 예시

1. Docker DB → 로컬 백업

# Docker DB 백업
python backup_db.py
# 결과: backups/edwards_backup_20260130_HHMMSS.sql

2. 로컬 DB → 서버 복원

# .env에 SERVER_DATABASE_URL 설정 필요
cd backend
python -m scripts.db_backup --restore backup_20260130.sql --target server
# 확인 프롬프트: "yes" 입력

3. 새 PC로 데이터 이전

# 원본 PC
python backup_db.py

# 새 PC (backups/ 폴더에 파일 복사 후)
python restore_db.py edwards_backup_20260130_120000.sql

주의사항

• 복원 시 기존 데이터 삭제됨: 복원 전 현재 DB 백업 권장
• 서버 복원 시 확인 필요: --server 옵션 사용 시 "yes" 입력 필요
• Docker 컨테이너 필수: Docker 명령은 컨테이너 실행 중이어야 함
• pg_dump 필요: 로컬 명령은 PostgreSQL 클라이언트 도구 필요

참고 파일

• backup_db.py - Docker 백업 스크립트
• restore_db.py - Docker 복원 스크립트
• backend/scripts/db_backup.py - 전체 기능 유틸리티