복원

개요

QKS는 생성된 백업을 사용하여 클러스터의 리소스와 퍼시스턴트 볼륨을 복원할 수 있습니다. 실수로 삭제된 리소스 복구, 장애 발생 시 이전 상태로 롤백, 또는 다른 클러스터로 리소스 마이그레이션 시 활용합니다.

---

복원 절차

1. 왼쪽 메뉴에서 Backup을 선택합니다.
2. 복원에 사용할 백업을 목록에서 클릭합니다.
3. 백업 상세 페이지에서 복원 버튼을 클릭합니다.
4. 다음 항목을 설정합니다:

항목	설명
복원 이름	복원 작업의 이름
복원할 네임스페이스	전체 또는 특정 네임스페이스만 선택
네임스페이스 매핑	다른 네임스페이스로 복원할 경우 원본→대상 매핑 설정
기존 리소스 처리	이미 존재하는 리소스를 건너뛸지(skip) 또는 덮어쓸지(overwrite) 선택
볼륨 복원	퍼시스턴트 볼륨도 함께 복원할지 여부

1. 복원 버튼을 클릭합니다.

---

복원 상태

상태	설명
New	복원 요청이 생성되었습니다.
InProgress	복원이 진행 중입니다.
Completed	복원이 성공적으로 완료되었습니다.
Failed	복원 중 오류가 발생했습니다.
PartiallyFailed	일부 리소스의 복원에 실패했습니다.

---

복원 후 확인

복원이 완료되면 다음 사항을 확인합니다:

# 복원된 네임스페이스의 파드 상태 확인
kubectl get pods -n <namespace>

# 복원된 PVC 확인
kubectl get pvc -n <namespace>

# 이벤트 확인 (복원 중 오류가 있었는지)
kubectl get events -n <namespace> --sort-by='.lastTimestamp'

---

주의사항

• 기존 리소스 덮어쓰기: overwrite 옵션 사용 시 현재 운영 중인 리소스가 백업 시점의 설정으로 되돌아갑니다. 신중하게 사용하세요.
• 볼륨 복원: 실행 중인 파드가 PVC를 사용 중이면 볼륨 복원이 실패할 수 있습니다. 해당 파드를 먼저 중단(scale down)하고 복원하는 것을 권장합니다.
• 복원 범위: 복원은 백업이 생성된 시점의 리소스 상태로만 되돌릴 수 있습니다.
• 클러스터 시스템 리소스: kube-system 등 시스템 네임스페이스는 복원하지 않는 것을 권장합니다. 시스템 구성 요소가 충돌할 수 있습니다.