핵심 요약
- 사이트마다 db.sql.gz와 media.tar.gz를 한 쌍으로 만들고 목록 파일 한 줄로 사이트를 추가한다.
- --single-transaction으로 일관된 덤프를 만들되, 배포의 migrate와 백업 시간대는 겹치지 않게 한다.
- 백업 직후 임시 컨테이너에서 행 수와 파일 수를 비교하는 복구 시험을 자동으로 돌린다.
50개 사이트 백업은 사이트마다 DB 덤프와 미디어 아카이브를 한 쌍으로 만들고, 별도 환경에서 복구까지 돌려 보면 자동화할 수 있습니다. DB 쪽 핵심은 --single-transaction입니다. MariaDB 공식 문서에 따르면 이 옵션은 모든 테이블을 하나의 트랜잭션으로 덤프해 일관된 스냅샷을 만듭니다. InnoDB 테이블을 잠그지 않고 덤프할 수 있어서, 서비스 중인 Django 사이트에 쓰기 좋습니다.
사이트별로 쪼개는 이유
사이트 50개를 --all-databases 덤프 하나로 묶으면 복구가 불편합니다. 한 사이트만 되돌리려 해도 전체 덤프를 뒤져야 하기 때문입니다. 그래서 사이트마다 DB 이름, 미디어 경로, 백업 파일명을 규칙으로 정해 두었습니다. 사이트 목록은 한 줄에 사이트명:DB명:미디어경로 형식으로 적어 둔 텍스트 파일 하나로 관리합니다.
백업 파일은 백업루트/사이트명/날짜/ 아래에 db.sql.gz와 media.tar.gz를 한 쌍으로 둡니다. 사이트를 추가할 때는 목록에 한 줄만 넣으면 됩니다. 스크립트를 수정하지 않아도 되는 구조입니다.
MariaDB 덤프 자동화
덤프 스크립트의 뼈대는 아래와 같습니다. 인증 정보는 명령줄에 쓰지 않고 ~/.my.cnf에 둡니다.
#!/usr/bin/env bash
set -euo pipefail
ROOT=/backup
DATE=$(date +%F)
while IFS=: read -r SITE DB MEDIA; do
DIR="$ROOT/$SITE/$DATE"
mkdir -p "$DIR"
mariadb-dump --single-transaction --routines "$DB" \
| gzip > "$DIR/db.sql.gz"
tar -czf "$DIR/media.tar.gz" -C "$MEDIA" .
done < sites.txt
set -euo pipefail을 빼면 덤프가 중간에 실패해도 gzip이 정상 종료해 빈 파일이 성공처럼 남습니다. 파이프 실패를 잡아내는 이 한 줄이 중요합니다.
주의할 점도 있습니다. 같은 공식 문서는 --single-transaction 덤프 중에 ALTER TABLE, DROP TABLE, RENAME TABLE, TRUNCATE TABLE을 다른 연결에서 실행하면 안 된다고 안내합니다. 스냅샷이 이런 문장들로부터는 격리되지 않기 때문입니다. Django 배포 시 migrate가 이 스키마 변경 문장을 실행하므로, 백업 시간대와 배포 시간대가 겹치지 않게 해야 합니다. 저는 배포 스크립트가 백업 락 파일을 확인하도록 해서 겹치는 일을 막았습니다.
미디어 파일과 Docker 볼륨
미디어가 Docker 볼륨에 있다면 호스트 경로를 직접 건드릴 필요가 없습니다. Docker 공식 문서에 따르면 임시 컨테이너를 띄워 볼륨을 마운트하고 tar로 백업하거나 복원할 수 있습니다.
docker run --rm \
-v site01_media:/data:ro \
-v /backup/site01/2026-11-19:/out \
alpine tar czf /out/media.tar.gz -C /data .
볼륨을 :ro로 마운트하면 백업 중 실수로 원본을 건드릴 일이 없습니다. 복원은 마운트 방향을 뒤집어 같은 방식으로 합니다. 이때 복원 대상은 운영 볼륨이 아니라 site01_media_restore 같은 새 볼륨으로 잡습니다.
복구 시험 절차
백업은 복구까지 해 봐야 확인됩니다. 그래서 백업 직후 자동으로 복구 시험을 돌립니다. 순서는 다음과 같습니다.
- 임시 MariaDB 컨테이너를 띄우고 빈 DB를 만든다.
gunzip -c db.sql.gz | mariadb 시험DB로 덤프를 적재한다.- 핵심 테이블(
auth_user등)의 행 수를 운영 DB와 비교한다. - 미디어 아카이브를 임시 볼륨에 풀어 파일 개수를 비교한다.
- 결과를 사이트별로 기록하고 임시 컨테이너와 볼륨을 지운다.
50개 전부를 매일 시험하면 시간이 오래 걸립니다. 그래서 매일 3~5개를 순환하며 시험하고, 월 1회는 전체를 돌립니다. 복구 소요 시간은 환경마다 크게 다릅니다. 이 글에서는 수치를 제시하지 않으니, 직접 시험해서 기록해 두세요. 이 시간이 곧 장애 때 복구 목표 시간의 근거가 됩니다.
실천 가이드
처음부터 50개를 다 붙이지 말고 아래 순서로 진행하길 권합니다.
| 단계 | 할 일 | 확인 기준 |
|---|---|---|
| 1 | 사이트 1개로 덤프·tar 스크립트 작성 | 파일 쌍이 생성됨 |
| 2 | 임시 컨테이너로 복구 시험 | 행 수·파일 수 일치 |
| 3 | 사이트 목록 파일로 확장 | 목록 한 줄 추가로 동작 |
| 4 | 배포·백업 시간대 분리 | 겹침 방지 확인 |
| 5 | 복구 시간 측정·기록 | 사이트별 소요 시간 문서화 |
백업 스크립트가 성공했다는 로그만으로는 부족합니다. 복구 시험 결과가 함께 남아야 백업이 쓸 수 있다는 근거가 됩니다. 이 두 가지를 같은 파이프라인에 넣어 두면, 사이트가 늘어도 운영 부담은 크게 늘지 않습니다.
자주 묻는 질문
Q. mariadb-dump에서 --single-transaction은 왜 쓰나요?
모든 테이블을 하나의 트랜잭션으로 덤프해 일관된 스냅샷을 만들고, InnoDB 테이블을 잠그지 않아 서비스 중인 사이트에 쓰기 좋습니다. 다만 덤프 중 다른 연결에서 ALTER TABLE, DROP TABLE, RENAME TABLE, TRUNCATE TABLE을 실행하면 안 됩니다.
Q. Django 배포와 백업이 겹치면 왜 문제가 되나요?
배포 시 migrate가 스키마 변경 문장을 실행하는데, 스냅샷은 이런 문장으로부터 격리되지 않기 때문입니다. 글쓴이는 배포 스크립트가 백업 락 파일을 확인하게 해서 겹침을 막았습니다.
Q. 50개 사이트의 복구 시험은 얼마나 자주 하나요?
매일 3~5개 사이트를 순환하며 시험하고, 월 1회는 전체를 돌립니다. 복구 소요 시간은 환경마다 다르므로 직접 측정해 기록해 두는 것이 좋습니다.
참고 자료
이 글은 웹 검색으로 확인한 위 출처를 바탕으로 AI(claude-sonnet-5-5)가 작성했습니다. 수치·가격은 출처 원문에서 다시 확인하세요.