본문으로 건너뛰기

백업/복구 시나리오

KIWI에서 Kubernetes etcd, Docker 컨테이너, 외부 스토리지의 백업 및 복구를 설정하는 방법을 안내합니다.

백업 유형​

유형설명대상권장 주기
etcd 백업K8s 클러스터 상태 백업Kubernetes 클러스터매일
Docker 백업컨테이너 및 볼륨 백업Docker/Podman 런타임매일
외부 스토리지MinIO, S3 등 외부 저장소 백업파일 스토리지주간

시나리오 1: etcd 백업 설정하기​

Q. Kubernetes 클러스터의 etcd를 백업하고 싶습니다​

사전 조건: Kubernetes 클러스터가 **[런타임 환경]**에 등록되어 있어야 합니다.

단계별 안내:

Step 1: 백업 관리 페이지 이동​

  • 이동 경로: [백업 관리]
  • UI 요소: 좌측 메뉴에서 "백업 관리" 클릭

Step 2: etcd 백업 탭 선택​

  • UI 요소: etcd백업탭 - 상단 탭에서 "etcd 백업" 클릭

Step 3: 백업 대상 클러스터 선택​

  • UI 요소: 클러스터선택드롭다운 - 백업할 K8s 클러스터 선택
  • 확인: 클러스터 연결 상태가 "연결됨"인지 확인

Step 4: 백업 설정 구성​

  • 입력 항목:
    항목설명예시
    백업 이름식별 가능한 이름etcd-daily-backup
    저장 위치백업 파일 저장 경로/backup/etcd/
    보관 기간백업 보관 일수30일
    스케줄cron 표현식0 2 * * * (매일 새벽 2시)

Step 5: 즉시 백업 실행 (선택사항)​

  • UI 요소: 즉시백업버튼 - "지금 백업" 버튼 클릭
  • 확인: 백업 진행 상태 확인

Step 6: 백업 완료 확인​

  • UI 요소: 백업목록테이블 - 백업 이력 확인
  • 정보 포함:
    • 백업 시간
    • 백업 크기
    • 상태 (성공/실패)

시나리오 2: Docker 컨테이너 백업하기​

Q. Docker 컨테이너와 볼륨을 백업하고 싶습니다​

사전 조건: Docker 런타임이 **[런타임 환경]**에 등록되어 있어야 합니다.

단계별 안내:

Step 1: 백업 관리 페이지 이동​

  • 이동 경로: [백업 관리]

Step 2: Docker 백업 탭 선택​

  • UI 요소: Docker백업탭 - 상단 탭에서 "Docker 백업" 클릭

Step 3: 백업 대상 선택​

  • 선택 항목:
    대상설명
    컨테이너실행 중인 컨테이너 상태 백업
    볼륨데이터 볼륨 백업
    이미지컨테이너 이미지 백업

Step 4: 백업 옵션 설정​

  • 입력 항목:
    항목설명
    압축 방식gzip, tar 등
    저장 위치로컬 또는 원격 경로
    제외 패턴백업에서 제외할 항목

Step 5: 백업 실행​

  • UI 요소: "백업 시작" 버튼 클릭
  • 확인: 백업 진행률 모니터링

시나리오 3: 외부 스토리지 백업 설정하기​

Q. MinIO나 S3에 백업을 저장하고 싶습니다​

단계별 안내:

Step 1: 백업 관리 페이지 이동​

  • 이동 경로: [백업 관리]

Step 2: 스토리지 설정 탭 선택​

  • UI 요소: 스토리지설정탭 - "스토리지 설정" 클릭

Step 3: 외부 스토리지 추가​

  • UI 요소: 스토리지추가버튼 - "스토리지 추가" 버튼 클릭
  • 지원 유형:
    유형설명
    MinIO온프레미스 오브젝트 스토리지
    AWS S3Amazon S3 호환 스토리지
    NFS네트워크 파일 시스템

Step 4: 스토리지 연결 정보 입력​

  • MinIO 입력 예시:
    항목설명예시
    엔드포인트MinIO 서버 주소minio.company.com:9000
    Access Key접근 키admin
    Secret Key비밀 키********
    버킷 이름저장할 버킷kiwi-backup

Step 5: 연결 테스트 및 저장​

  • UI 요소: "연결 테스트" 버튼 클릭
  • 확인: 연결 성공 메시지 확인 후 "저장"

시나리오 4: 백업에서 복구하기​

Q. 이전 백업에서 시스템을 복구하고 싶습니다​

주의사항: 복구 작업은 기존 데이터를 덮어씁니다. 신중히 진행하세요.

단계별 안내:

Step 1: 백업 관리 페이지 이동​

  • 이동 경로: [백업 관리]

Step 2: 복구 이력 탭 선택​

  • UI 요소: 복구이력탭 - "복구 이력" 탭 클릭

Step 3: 복구할 백업 선택​

  • UI 요소: 백업목록테이블 - 복구할 백업 항목 선택
  • 확인 정보:
    • 백업 날짜/시간
    • 백업 크기
    • 백업 유형 (etcd/Docker/스토리지)

Step 4: 복구 대상 확인​

  • UI 요소: 복구미리보기 - 복구될 항목 확인
  • 경고: 현재 데이터가 백업 시점으로 덮어써짐

Step 5: 복구 실행​

  • UI 요소: "복구 시작" 버튼 클릭
  • 확인: 관리자 비밀번호 입력 (보안 확인)

Step 6: 복구 완료 확인​

  • 확인 사항:
    • 복구 상태: 성공/실패
    • 복구 소요 시간
    • 복구된 항목 목록

시나리오 5: 자동 백업 스케줄 설정하기​

Q. 매일 자동으로 백업되도록 설정하고 싶습니다​

단계별 안내:

Step 1: 백업 관리 페이지 이동​

  • 이동 경로: [백업 관리]

Step 2: 스케줄 설정 탭 선택​

  • UI 요소: 스케줄설정탭 - "스케줄 설정" 탭 클릭

Step 3: 새 스케줄 생성​

  • UI 요소: 스케줄추가버튼 - "스케줄 추가" 버튼 클릭

Step 4: 스케줄 설정​

  • 입력 항목:
    항목설명예시
    스케줄 이름식별 가능한 이름daily-full-backup
    실행 주기백업 실행 빈도매일 / 매주 / 매월
    실행 시간백업 실행 시각02:00
    백업 대상etcd / Docker / 전체전체
    보관 정책백업 보관 개수/기간최근 30개

Step 5: 알림 설정 (선택사항)​

  • 옵션:
    알림 유형설명
    성공 알림백업 성공 시 알림
    실패 알림백업 실패 시 알림
    이메일알림 수신 이메일

Step 6: 스케줄 활성화​

  • UI 요소: "저장 및 활성화" 버튼 클릭
  • 확인: 스케줄 목록에서 활성 상태 확인

관련 질문​

자주 묻는 질문​

질문답변관련 페이지
백업이 실패합니다저장 공간 및 권한 확인[백업 관리]
복구 후 서비스가 정상 작동하지 않습니다백업 시점의 설정 호환성 확인[백업 관리]
백업 용량이 너무 큽니다압축 설정 및 제외 패턴 확인[백업 관리]
외부 스토리지 연결이 안 됩니다네트워크 및 인증 정보 확인[백업 관리]

다음 단계​

백업 설정이 완료되면 다음 작업을 진행하세요:

  • 복구 테스트를 정기적으로 실행하여 백업 유효성 검증
  • 백업 모니터링 대시보드에서 백업 상태 확인
  • 중요 변경 전 수동 백업 실행