InfraGuard

백업 보관소(Vaults)

백업 파일이 저장되는 보관소(저장 대상)를 카드로 관리하고 저장량·용량·오프사이트(3-2-1)를 한눈에 봅니다.

개요 — 무엇을 하나

백업 보관소(Vaults) 는 백업 결과물이 실제로 쌓이는 저장 대상(storage target) 을 관리하는 화면입니다. 로컬 경로·원격 rsync/SSH·S3·NFS 같은 "어디에 저장하나"를 이름 붙은 보관소로 등록해 두면, 여러 백업 작업이 이 보관소를 공유해서 쓸 수 있습니다.

각 보관소 카드는 무엇이 얼마나 저장되어 있는지(연결된 백업 계획 수 · 저장량 · 용량 · 사용률)와 오프사이트 여부(3-2-1 규칙)를 보여 주고, 카드에서 바로 추가·편집·삭제(CRUD)할 수 있습니다.

이 화면의 "도메인" 계열 용어는 웹 TLD 를 뜻하지 않습니다. 여기서 다루는 것은 순수하게 저장 대상(보관소) 이며, 백업 파일이 놓이는 물리/원격 위치입니다.

언제 쓰나

화면 구성

히어로 + KPI 스트립

상단 KPI 6종은 전체 보관소를 집계합니다.

KPI 의미 계산
보관소 등록된 보관소 총 개수 count(vaults)
호스트 보관소가 거주하는 고유 원격 호스트 수 host 값이 빈 문자열(=로컬)인 것은 제외한 distinct count
오프사이트 오프사이트로 표시된 보관소 수 offsite = true 개수
계획 이 보관소들을 대상으로 하는 백업 작업(계획) 합계 Σ job_count
저장량 저장된 용량 합계 Σ stored_bytes
용량 등록된 용량 합계 Σ capacity_bytes (미입력 보관소가 있으면 —)

보관소 카드 그리드

보관소마다 카드 하나. 카드 구성:

보관소 편집 모달

[보관소 추가] 또는 카드 편집을 누르면 작은 모달이 뜹니다.

필드 설명
이름 보관소 표시 이름(비우면 "보관소")
유형(kind) local · rsync · ssh · s3 · nfs · other
상태(status) active · full · offline · retired
호스트(원격) rsync/ssh/s3 엔드포인트 호스트
경로/URI 베이스 경로 또는 s3://bucket/prefix
거주 인스턴스 infr_instance 참조(보관소가 사는 호스트)
스토리지 자산 infr_storage 참조(자산 스토리지 & 파일)
용량 숫자 + 단위(KB/MB/GB/TB) — 저장 시 바이트로 환산
자격 참조(cred_ref) env:PREFIX 또는 vault 참조. 예: env:BK_S3 — 비밀 인라인 금지
오프사이트 보관 3-2-1의 "1벌은 오프사이트" 체크박스
메모 자유 메모

사용법

보관소 등록

  1. 우상단 [보관소 추가] 클릭.
  2. 이름·유형을 정하고, 원격이면 호스트/경로(URI) 를 입력합니다.
  3. 용량을 숫자+단위로 입력하면 카드에서 사용률(저장량 ÷ 용량)을 볼 수 있습니다.
  4. 자격이 필요하면 cred_ref 에 참조만 둡니다(예: env:BK_S3). 실제 키·비밀번호는 절대 여기 넣지 않습니다.
  5. 원격지(다른 건물·리전·클라우드)에 있으면 오프사이트 보관을 체크합니다.
  6. [저장] — 저장 후 목록이 갱신되고, stored_bytes 는 다음 live 조회에서 다시 계산됩니다.

3-2-1 규칙 점검

3-2-1 규칙 — 데이터 사본을 3벌 만들어, 서로 다른 저장 매체 2종에 두고, 그중 1벌은 물리적으로 떨어진 장소(오프사이트)에 보관합니다. 화재·도난·랜섬웨어로 원본이 망가져도 멀리 있는 사본으로 복구할 수 있습니다.

오프사이트 연쇄 백업(SSH 키)

오프사이트 사본을 자동으로 이어서 만드는 설정은 스크립트 빌더에 있습니다. 동작 개념:

  1. 1차 백업(예: mysqldump 산출물)이 끝나면,
  2. 방금 만든 파일을 오프사이트 보관소로 한 번 더 복사합니다(3-2-1의 "1벌은 오프사이트").
  3. 원격 복사는 SSH 키로 인증합니다(비밀번호를 스크립트에 넣지 않음).
  4. 오프사이트 복사가 실패해도 1차 백업은 그대로 보존됩니다.

빌더에서 "오프사이트 연쇄 백업"을 켜려면 미리 이 화면에서 오프사이트 보관소를 하나 이상 등록해 두어야 합니다(없으면 빌더가 "등록된 오프사이트 보관소가 없습니다" 안내를 표시).

보관소 삭제

데이터 소스

id, key(slug·선택), name, kind(local|rsync|ssh|s3|nfs|other),
host, path, instance_id(→infr_instance), storage_id(→infr_storage),
capacity_bytes, cred_ref(env:PREFIX/vault), offsite(bool),
status(active|full|offline|retired), tags(json), note, seq, created_by, timestamps

stored_bytes 는 디스크의 실제 사용량이 아니라 각 작업의 "마지막 성공 백업 파일 크기"의 합입니다. 세대 보존(여러 개 유지)을 하는 보관소라면 실제 점유 용량은 이보다 클 수 있습니다. 정확한 실디스크 사용량·RAID 상태는 인프라 ▸ 스토리지 & RAID와 자산 ▸ 스토리지 & 파일에서 확인하세요.

권한

문제해결 · FAQ

Q. 카드에 아무 보관소도 안 보여요. 아직 등록된 보관소가 없습니다. [보관소 추가] 로 첫 보관소를 만드세요. 백업 작업을 이미 만들었다면 스크립트 빌더에서 작업에 보관소를 지정할 때도 여기 등록된 보관소가 후보로 뜹니다.

Q. 저장량이 0 이거나 실제와 달라요. stored_bytes 는 이 보관소를 쓰는 작업들의 마지막 성공 실행 바이트 합입니다. 아직 성공한 실행이 없으면 0, 세대 보존을 한다면 실제보다 작게 보일 수 있습니다. 실행 이력은 백업 실행 이력에서 확인하세요.

Q. 용량 칸에 ? 가 떠요. 용량을 아직 입력하지 않은 것입니다. 쓰기 권한이 있으면 그 칸을 클릭하면 바로 편집 모달이 열립니다. 용량을 넣어야 사용률(포화도) 판단이 됩니다.

Q. 삭제가 안 되고 "사용 중" 이라고 나와요. 그 보관소를 대상으로 하는 백업 작업이 남아 있습니다(409). 해당 작업의 보관소를 다른 것으로 바꾼 뒤 다시 삭제하세요.

Q. cred_ref 에 실제 비밀번호를 넣어도 되나요? 아니요. cred_ref 는 참조만 담습니다(env:PREFIX 또는 vault 참조). 실제 자격은 백업 서버의 --defaults-extra-file(0600) 이나 SSH 키로만 두세요. 스크립트·DB 에 비밀을 인라인하지 않는 것이 InfraGuard 의 규칙입니다.

Q. 오프사이트 보관소가 빌더에 안 뜹니다. 빌더의 "오프사이트 연쇄 백업"은 offsite = true 로 표시된 보관소만 후보로 사용합니다. 이 화면에서 원격지 보관소를 등록하고 오프사이트 체크박스를 켠 뒤 다시 시도하세요.

관련 항목

보관소(Vault) 목록
보관소(Vault) 목록