긴 백업 공백 없이 Borg 가지치기 및 압축 설정하는 방법

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

Borg 백업이 장시간 중단되는 일을 피하려면, 백업이 성공적으로 완료된 후 보존 정리를 실행하되 저장소 압축은 더 드물게, 주요 백업 시간대 외에 예약하세요. Borg 1.4는 아카이브 삭제와 실제 공간 회수를 분리하므로, borg prune을 실행할 때마다 borg compact를 실행할 필요는 없습니다.

이 가이드는 현재 안정 버전인 Borg 1.4.x의 명령 모델을 기준으로 합니다. Borg 2는 여러 부분에서 저장소 및 아카이브의 의미를 변경하므로, 다른 주요 버전의 자동화 명령을 복사하기 전에 설치된 버전을 확인하세요.

Borg 버전과 저장소 확인하기

borg --version
borg info /mnt/backup/borg-repo
borg list /mnt/backup/borg-repo

Borg FAQ에 따르면 Borg는 저장소 전체를 잠그며, 한 번에 하나의 프로세스만 쓰기 권한을 가질 수 있습니다. 오래 걸리는 압축 작업이 다음 예약 백업 시간과 겹치면 백업은 잠금이 풀릴 때까지 대기하거나 잠금 시간 제한이 만료되어 실패합니다.

먼저 시험 실행으로 보존 정책을 정의하세요

borg prune은 아카이브 기록을 삭제하는 작업입니다. Borg의 정리 문서에서는 --dry-run 및 --list를 사용해 테스트할 것을 강력히 권장합니다.

borg prune   --dry-run   --list   --keep-daily 7   --keep-weekly 4   --keep-monthly 6   --glob-archives '{hostname}-*'   /mnt/backup/borg-repo

하나의 저장소에 여러 머신이나 데이터 세트의 백업이 들어 있다면 아카이브 필터가 필수입니다. 제한적인 필터가 없으면 Borg 1.4는 저장소의 모든 아카이브를 동일한 보존 규칙의 후보로 간주합니다.

백업이 성공적으로 완료된 후에만 정리를 실행하세요

#!/bin/sh
set -eu
REPO=/mnt/backup/borg-repo
ARCHIVE='{hostname}-{now:%Y-%m-%d_%H-%M}'

borg create --stats "$REPO::$ARCHIVE" /srv/data

borg prune   --list   --keep-daily 7   --keep-weekly 4   --keep-monthly 6   --glob-archives '{hostname}-*'   "$REPO"

스케줄러가 실행되었다는 이유만으로 정리하지 마세요. 새 백업이 성공적으로 완료되고 보존 정책이 이미 검증되었을 때 정리하세요.

정리 후에도 공간이 즉시 확보되지 않는 이유 알아보기

Borg 1.2부터 압축은 일반 저장소 쓰기 명령과 분리되었습니다. Borg의 별도 압축 안내에 따르면 아카이브를 삭제하거나 정리해도 저장소의 디스크 공간이 모두 즉시 회수되지는 않습니다.

borg create
    |
새 아카이브 커밋
    |
borg prune
    |
보존 대상에서 오래된 아카이브 제거
    |
borg compact
    |
사용하지 않는 세그먼트 공간 회수

이렇게 예약하면 매일 백업할 때 일부만 사용된 저장소 세그먼트를 다시 쓰는 데 드는 전체 비용을 부담하지 않아도 됩니다.

정리는 압축보다 덜 자주 실행하도록 예약하세요

  • 백업: 매일 밤
  • 정리: 백업이 성공적으로 끝난 후마다 또는 주 몇 회
  • 압축: 한가한 시간대에 주 1회
  • 전체 저장소 점검: 별도의 더 드문 주기로 실행합니다.
# 일일 백업 + 정리
0 1 * * * /usr/local/sbin/borg-backup

# 매주 compact
0 4 * * 0 /usr/local/sbin/borg-compact

백업이 몇 시간씩 걸리는 경우가 많다면 compact를 더 나중으로 미루거나, 명시적 종속성을 설정한 타이머를 사용하세요.

최대 재작성을 강제하기 전에 기본 compact 임계값 사용하기

현재 compact 문서에서는 기본 임계값으로 10%를 사용합니다.

borg compact --progress /mnt/backup/borg-repo

유지 관리 시간을 짧게 유지하는 것이 우선이라면 이 기본값으로 시작하는 것이 좋습니다. --threshold 0을 자동으로 사용하지 마세요. 공간을 조금이라도 절약할 수 있으면 데이터를 다시 쓰기 때문에 대규모 저장소에서는 상당히 느려질 수 있습니다.

유지 관리 작업이 다음 백업과 겹치지 않도록 하세요

다른 Borg 프로세스를 기다리는 것이 정상일 수 있는 작업이라면, 제한된 잠금 대기 시간을 설정하세요.

borg --lock-wait 1800 create   /mnt/backup/borg-repo::'{hostname}-{now}'   /srv/data

일정을 잘 짜는 대신 잠금 대기 시간을 지나치게 길게 설정하지 마세요. 백업이 실제로 언제 시작하고 끝나는지 모니터링하세요.

여러 클라이언트가 하나의 저장소를 공유한다면 일정을 분산하세요. Borg FAQ에 따르면 클라이언트 간 중복 제거가 중요하지 않은 경우 여러 저장소를 사용하면 잠금 경합을 줄일 수 있습니다.

prune 보고서가 느려지면 Quick Stats 사용하기

Borg 1.4.5에서는 create, delete, prune에 --quick-stats 옵션이 추가되어, 필요하지 않은 경우 저장소 전체 통계를 계산하는 느린 작업을 건너뛸 수 있습니다.

borg prune   --quick-stats   --keep-daily 7   --keep-weekly 4   --keep-monthly 6   --glob-archives '{hostname}-*'   /mnt/backup/borg-repo

compact가 필요하기 전에 여유 공간을 확보하세요

저장소 파일 시스템의 여유 공간이 0이 될 때까지 기다리지 마세요. 파일 시스템이 완전히 가득 차면 Borg가 저장소에 쓰는 일반 작업을 안정적으로 수행할 수 없습니다.

df -h /mnt/backup
borg info /mnt/backup/borg-repo

더 폭넓은 NAS 백업 계획을 세울 때 ZimaOS 3-2-1 백업 가이드를 참고하면 저장소 보존 정책은 백업 설계의 한 계층일 뿐이라는 점을 기억하는 데 도움이 됩니다.

일정을 신뢰하기 전에 검증하기

  • 백업이 실행될 때마다 새 아카이브가 생성되었나요?
  • 백업이 성공한 경우에만 prune이 실행되었나요?
  • 보존할 항목이 드라이런 계획과 일치했나요?
  • 매주 실행하는 compact가 다음 백업 전에 끝났나요?
  • compact 후 여유 공간이 늘었나요?
  • 어떤 작업에서 Borg 잠금을 기다리느라 예상보다 많은 시간이 걸렸나요?

compact 작업이 다음 백업과 반복해서 겹치면 compact 실행 빈도를 낮추고, 기본 임계값을 유지하거나, 더 한가한 시간대로 compact를 옮기거나, 관련 없는 작업을 별도의 저장소로 분리하세요.

간격을 최소화하는 Borg 유지 관리 패턴

매일
01:00  borg create
        |
        +-- 성공 --> borg prune
        |
        +-- 실패 --> 기존 아카이브 유지, 알림

매주
04:00  borg compact

주기적
        borg check
        선택한 파일 복원 테스트

핵심 원칙은 간단합니다. prune은 보존 정책을 지키고, compact는 저장 공간을 회수합니다. 두 작업을 같은 주기로 실행할 필요는 없습니다.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.