Astro 블로그는 무엇을 백업해야 할까, 직접 해본 복구 시험
목차 보기
Ghost를 운영할 때는 글만 백업한다고 끝나지 않았습니다. 데이터베이스와 이미지, 설정 파일, 테마와 웹 서버 구성을 함께 생각해야 했습니다. Astro로 옮기면 데이터베이스가 사라지니 백업도 아주 간단해질 것 같았습니다.
실제로 구조는 단순해졌습니다. 하지만 Markdown 글만 복사해두면 사이트 전체를 복구할 수 있는 것은 아닙니다. 디자인 코드와 이미지, 빌드 설정, 설치할 패키지의 버전을 함께 보관해야 원래 모습으로 다시 만들 수 있습니다.
처음 이 글을 쓴 8월 9일에는 배포할 때마다 소스와 배포 결과물을 묶어 따로 보관했습니다. 9월 26일에 다시 확인해 보니 배포를 자동화한 뒤로 그 단계가 빠져 있었습니다. 그래서 현재 상태를 사실대로 고치고, 미뤄두었던 복구 시험도 직접 해봤습니다.
데이터베이스가 없어도 백업이 필요한 이유
Astro 블로그의 글 작성과 배포 과정에서 설명했듯이 minml의 글은 데이터베이스가 아니라 Markdown 파일에 저장됩니다. 그만큼 프로젝트 폴더가 사이트의 원본에 가까워졌습니다. 이 폴더를 잃어버리면 다음 내용도 함께 사라집니다.
- 작성한 글과 고정 페이지
- 대표 이미지와 본문 이미지
- 홈페이지와 글 화면의 디자인
- 주소와 리디렉션 설정
- RSS와 사이트맵 구성
- 빌드와 검사 스크립트
- 사용 중인 패키지와 버전 정보
서버에 HTML이 남아 있다면 방문자가 사이트를 보는 것은 가능할 수 있습니다. 하지만 HTML만 가지고 원래 Markdown과 Astro 구성 요소를 완전히 되돌리는 일은 어렵습니다. 공개된 결과물과 수정 가능한 원본은 역할이 다릅니다.
소스 백업과 배포 결과물 백업
| 백업 종류 | 들어 있는 내용 | 사용하는 상황 |
|---|---|---|
| 소스 | 글, 이미지, Astro 코드와 설정 | 수정 가능한 프로젝트 전체 복구 |
| 배포 결과물 | 빌드가 끝난 HTML, CSS와 이미지 | 직전 사이트를 빠르게 다시 공개 |
소스가 있으면 프로젝트를 다시 설치하고 빌드할 수 있습니다. 대신 Node.js와 패키지를 설치하고 빌드 검사를 거쳐야 하므로 시간이 필요합니다.
배포 결과물은 이미 완성된 정적 사이트입니다. 새 배포가 잘못됐을 때 이전 공개 상태로 빠르게 돌아갈 수 있지만, 글을 수정하거나 디자인을 계속 개발하기 위한 원본으로 쓰기는 어렵습니다. 그래서 두 종류가 모두 필요합니다.
소스에 넣는 항목
src/content/posts/
src/content/pages/
src/layouts/
src/pages/
src/styles/
public/
scripts/
astro.config.mjs
src/content.config.ts
package.json
package-lock.json
tsconfig.json
src/content에는 Markdown 글과 각 글의 제목, 주소, 날짜 같은 정보가 있습니다. public에는 대표 이미지, 본문 이미지와 파비콘이 있습니다. 레이아웃과 스타일을 빼면 글은 복구돼도 현재의 화면은 돌아오지 않습니다.
astro.config.mjs에는 사이트의 기본 주소와 URL 형식, 사이트맵과 리디렉션 설정이 들어 있습니다. 이전 글 주소를 새 글로 보내는 규칙을 잃으면 백업에서 사이트를 되살려도 기존 링크 일부가 깨집니다.
package-lock을 함께 보관하는 이유
처음에는 package.json만 있으면 필요한 패키지를 다시 설치할 수 있다고 생각했습니다. 하지만 package.json에는 허용하는 버전 범위가 들어갈 수 있고, package-lock.json에는 실제로 결정된 의존성 트리가 기록됩니다. npm 공식 문서도 잠금 파일을 같은 의존성 트리를 다시 설치하기 위한 파일로 설명합니다.
그래서 두 파일은 한 묶음으로 취급하고, 복구할 때는 잠금 파일과 package.json이 일치하는지 검사하는 npm ci를 사용합니다. 설치된 패키지 폴더를 통째로 백업하는 대신 설치 기준을 보관하고 필요할 때 다시 만드는 방식입니다.
백업에서 제외한 항목
node_modules: 잠금 파일을 기준으로 다시 설치 가능.astro: Astro가 다시 만드는 작업 캐시dist: 배포 결과물로 따로 보관- 개발 서버 로그: 사이트 원본이 아님
- 기존 백업 폴더: 백업 안에 백업이 반복되는 것을 방지
- Ghost 마이그레이션 원본: 일반 백업과 분리해 비공개 보관
node_modules는 크기가 크고 파일 수도 많습니다. 운영체제나 Node.js 환경에 따라 다시 설치하는 편이 더 안전하기도 합니다.
dist를 따로 보관하는 이유
원칙적으로는 소스와 잠금 파일이 있으면 npm run build로 dist를 다시 만들 수 있습니다. 그래도 실제로 서버에 올린 결과물은 따로 남겨두는 편이 좋습니다. “이 소스로 비슷한 사이트를 다시 만들 수 있다”와 “그때 서버에 올라간 파일과 정확히 같은 결과가 있다”는 다른 상태이기 때문입니다. 아래 복구 시험에서 이 차이가 실제로 나타났습니다.
8월 9일의 백업 묶음
처음 이 글을 쓸 때 로컬에 남은 배포 시점별 백업을 확인했습니다. 백업 묶음은 14개였고, 가장 최근 묶음은 약 27.57MB였습니다.
| 파일 | 크기 | 역할 |
|---|---|---|
| 소스 압축본 | 약 13.82MB | 글과 이미지, 코드 및 설정 복구 |
| 배포 결과물 압축본 | 약 13.75MB | 직전 공개 사이트 복구 |
| 체크섬 기록 | 매우 작음 | 파일이 바뀌거나 손상됐는지 확인 |
| 서버 설정 백업 | 매우 작음 | 사이트 연결 설정 복구에 참고 |
소스 압축본에는 104개 항목이 있었고 node_modules, dist, 기존 백업과 마이그레이션 원본은 빠져 있었습니다. 배포 결과물에는 93개 항목이 있었고, 체크섬 기록에 등록된 세 파일도 다시 계산해 모두 일치했습니다.
9월 26일에 다시 확인한 현재 상태
8월 27일에 배포를 스크립트 하나로 자동화했습니다. 이 스크립트는 빌드, 검사, 업로드, 권한 정리와 공개 전환까지 처리하지만 로컬에 압축 백업을 만드는 단계는 넣지 않았습니다. 그 결과 로컬 백업 묶음은 8월 9일 것이 마지막이었고, 그 뒤에 발행한 글은 이 방식으로 백업되지 않았습니다.
현재 남아 있는 복구 수단은 두 가지입니다.
| 복구 수단 | 현재 상태 | 한계 |
|---|---|---|
| 로컬 Git 저장소 | 모든 커밋에 소스와 이미지가 들어 있음 | 원격 저장소가 없어 한 장소에만 있음 |
| 서버의 최근 릴리스 | 실제 배포본 5개를 보존 | 운영 서버와 같은 곳에 있어 서버 장애에는 대비하지 못함 |
서버에 남긴 릴리스는 배포 직후 문제를 되돌리는 데는 충분합니다. 하지만 백업이라기보다 롤백 지점에 가깝습니다. 릴리스를 몇 개 남기고 어떻게 되돌리는지는 Astro 사이트를 새 릴리스로 교체하는 이유에 정리했습니다.
새 폴더에서 해본 복구 시험
압축 목록과 체크섬이 맞는다는 것만으로는 사이트를 실제로 되살릴 수 있는지 알 수 없습니다. 그래서 9월 26일에 로컬 Git 저장소만 원본으로 삼아, 빈 폴더에서 사이트를 다시 만들고 운영 중인 릴리스와 파일 단위로 비교했습니다.
git clone <로컬-저장소> restore-test
cd restore-test
npm ci
npm run build
node scripts/verify-migration.mjs
| 확인 항목 | 결과 |
|---|---|
| 복제한 커밋 | 운영 중인 릴리스를 만든 커밋과 같음 |
| 추적 중인 파일 | 117개 |
| 설치부터 검증까지 걸린 시간 | 약 33초 |
| 검증 스크립트 | 공개 글 27편, 초안 10편, 고정 페이지 3개, 리디렉션 6개, HTML 44개 통과 |
| 결과물 파일 수 | 복구본 97개, 운영본 97개 |
| SHA-256이 같은 파일 | 97개 중 95개 |
다른 두 파일은 모두 Markdown 예시 코드 블록이 들어 있는 글이었습니다. 태그를 걷어내고 화면에 보이는 글자만 비교하면 두 파일 모두 운영본과 같았습니다. 차이는 코드 블록 안 프런트매터의 색상 표시용 태그뿐이었습니다. 같은 잠금 파일과 같은 코드 강조 패키지 버전으로 설치했는데도 결과가 달랐고, 정확한 원인은 아직 찾지 못했습니다.
방문자가 읽는 내용은 복구됐지만, 다시 만든 결과가 운영본과 바이트 단위까지 같지는 않았습니다. 앞에서 배포 결과물을 따로 보관하는 이유로 든 상황이 실제로 나타난 셈입니다.
설치 과정에서도 눈여겨볼 점이 있었습니다. 시험에 쓴 npm 11은 일부 패키지의 설치 스크립트를 승인하지 않은 상태로 두고 경고만 표시했습니다. 이번에는 그 상태로도 빌드가 성공했지만, 도구 버전이 바뀌면 복구 절차가 예전과 다르게 동작할 수 있다는 뜻입니다. 복구 시험을 한 번이 아니라 가끔 반복해야 하는 이유입니다.
두 가지 복구 경로
직전 사이트로 빠르게 돌아가는 경우
새 글이나 디자인을 배포한 뒤 오류가 발견됐다면 서버에 남은 직전 릴리스로 되돌립니다.
- 되돌릴 릴리스가 완전한지 확인합니다.
- 운영 폴더를 직접 덮어쓰지 않고, 공개 링크가 가리키는 대상만 이전 릴리스로 바꿉니다.
- 홈페이지, 주요 글, 이미지, 리디렉션과 사이트맵을 다시 확인합니다.
파일을 덮어쓰지 않고 가리키는 대상만 바꾸면 복구 도중 파일이 반쯤 섞이는 상태를 피할 수 있습니다.
편집 가능한 프로젝트 전체를 복구하는 경우
컴퓨터를 바꾸거나 프로젝트 폴더를 잃었다면 소스에서 다시 만듭니다. 위 복구 시험과 같은 순서입니다.
- 소스의 무결성과 내부 목록을 확인합니다.
- 새 작업 폴더에 소스를 준비합니다.
- 지원되는 Node.js 환경에서
npm ci로 패키지를 설치합니다. - 빌드와 검증 스크립트를 실행합니다.
- 필요하면 운영본과 파일을 비교한 뒤 새 배포를 진행합니다.
백업 파일을 공개하면 안 되는 이유
운영 중인 사이트의 백업에는 다음 정보가 섞일 수 있습니다.
- 서버 내부 경로와 계정 정보
- 데이터베이스 접속 정보
- API 키와 환경 변수
- 웹 서버와 인증서 설정
- 삭제한 글과 공개하지 않은 초안
minml의 소스에서는 .env를 제외하고, 서버 설정과 Ghost 시절 데이터는 공개 저장소에 올리지 않고 따로 보관합니다. 이 글에서도 실제 서버 주소, 내부 경로, 계정명과 체크섬 원문은 적지 않았습니다.
남은 약점
가장 큰 약점은 편집 가능한 원본이 한 장소에만 있다는 점입니다. 로컬 디스크가 고장 나면 서버의 릴리스로 화면은 되살릴 수 있어도 Markdown 원문과 디자인 코드는 되찾기 어렵습니다. 같은 컴퓨터 안의 다른 폴더로 복사하는 것만으로는 컴퓨터 전체 고장이나 랜섬웨어에 대비할 수 없습니다.
그래서 다음 두 가지를 우선 과제로 정했습니다.
- 배포 스크립트에 로컬 백업 묶음을 만드는 단계를 다시 넣거나, 비공개 원격 저장소에 소스를 한 부 더 두기
- 복구 시험을 분기마다 반복하고 결과를 이 글에 추가하기
Astro로 옮긴 뒤 데이터베이스 덤프와 CMS 프로그램 전체를 백업할 필요는 없어졌고, 무엇을 보관하는지도 훨씬 이해하기 쉬워졌습니다. 다만 이번 점검처럼 자동화를 바꾼 순간 백업 단계가 조용히 빠질 수 있으므로, 백업은 한 번 만들어 두는 설정이 아니라 주기적으로 복구해 보는 절차로 다루고 있습니다.