Database Backup & Restore Skill

Name: db-backup
Rating: 76
Author: cyanluna-git

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

사용법

bash

/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

명령	옵션	설명
`backup`	(없음)	Docker 컨테이너 내 DB 백업
`backup`	`--local`	로컬 PostgreSQL 백업 (localhost:5434)
`backup`	`--compressed`	압축 포맷 (.dump)
`list`		사용 가능한 백업 파일 목록
`restore`	`<file>`	지정 파일로 Docker DB 복원
`restore`	`<file> --local`	로컬 PostgreSQL로 복원
`restore`	`<file> --server`	서버 DB로 복원 (확인 필요)

실행 스크립트

Docker 환경 (기본)

bash

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

# 백업 (Docker)
python backup_db.py

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

로컬/서버 환경

bash

# 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)

변수	설명	기본값
`DATABASE_URL`	로컬 PostgreSQL 연결	`localhost:5434`
`SERVER_DATABASE_URL`	서버 PostgreSQL 연결	(미설정)
`POSTGRES_USER`	DB 사용자명	`postgres`
`POSTGRES_PASSWORD`	DB 비밀번호	`password`
`POSTGRES_DB`	DB 이름	`edwards`

백업 파일 위치

code

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

워크플로우 예시

1. Docker DB → 로컬 백업

bash

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

2. 로컬 DB → 서버 복원

bash

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

3. 새 PC로 데이터 이전

bash

# 원본 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 - 전체 기능 유틸리티