Harbor 백업 및 복원은 기존 GDC 백업 및 복원 아키텍처를 활용합니다. 이 시스템은 Kubernetes 환경을 위해 설계된 분산 백업 솔루션으로, 다음 구성요소로 구성됩니다.
커스텀 리소스는 백업을 정의하고 관리합니다.
백업은 객체 스토리지의 데이터베이스와 아티팩트 레지스트리 데이터 소스를 모두 타겟팅합니다.
시스템 설계에서 고가용성 및 재해 복구 고려사항을 다룹니다.
Harbor 백업 및 복원 시스템은 다음 구성요소로 구성됩니다.
HarborInstanceBackup 커스텀 리소스는 시스템과 상호작용하는 진입점입니다. 이 커스텀 리소스는 Harbor 백업 객체를 조정하는 데 사용되는 컨트롤러 집합을 가리킵니다. 시스템은 HarborInstanceBackup 리소스를 사용하여 사용자가 만드는 수동 백업과 백업 계획 일정에 따라 생성되는 자동 백업을 모두 만듭니다.
시스템은 이 컨트롤러 세트를 사용하여 Harbor 백업 객체를 조정합니다.
HarborInstanceBackupRepository 컨트롤러는 HarborInstanceBackupRepository 커스텀 리소스를 모니터링합니다. 이 리소스는 HarborInstanceBackupPlan 및 HarborInstanceBackup에서 참조할 백업 스토리지 타겟을 나타냅니다.
HarborInstanceBackupPlan 컨트롤러는 HarborInstanceBackupPlan 커스텀 리소스를 모니터링합니다. 이 리소스는 제공된 일정 및 보관 구성에 따라 지정된 Harbor 인스턴스에 HarborInstanceBackup 커스텀 리소스를 만듭니다.
HarborInstanceBackup 컨트롤러는 HarborInstanceBackup 맞춤 리소스를 모니터링하여 단일 Harbor 인스턴스의 영구 데이터 소스에 대한 두 가지 다른 백업 흐름을 관리합니다. 이러한 데이터 소스는 Harbor 데이터베이스의 메타데이터와 레지스트리 객체 저장소의 아티팩트 데이터입니다.
시스템은 S3 호환 객체 스토리지 버킷에 백업을 저장합니다.
복원 아키텍처는 백업 시스템의 설계를 반영합니다.
백업 저장소 만들기
Harbor 백업 저장소는 백업을 위한 S3 호환 스토리지 위치를 나타냅니다. 소프트웨어 배포에 필수적인 컨테이너 이미지를 관리하는 Harbor 인스턴스에는 안전하고 안정적인 백업 메커니즘이 필요합니다. 자세한 내용은 백업 저장소 만들기를 참고하세요.
백업 계획 만들기
Harbor 백업 계획은 Harbor 인스턴스 백업의 구성, 위치, 관리 기능을 제공합니다. 백업 계획을 사용하여 예약된 자동 백업을 만듭니다. 자세한 내용은 백업 계획 만들기를 참고하세요.
수동 백업 만들기
Harbor 백업에는 Harbor 인스턴스 데이터가 포함됩니다. 백업 계획을 사용하면 정의한 일정에 따라 백업이 생성됩니다. 필요한 경우 수동 백업을 만들 수도 있습니다. 자세한 내용은 수동 백업 만들기를 참고하세요.
백업 복원
GDC에서 Harbor 인스턴스의 백업을 복원합니다.
기존 백업을 사용하여 Harbor 인스턴스를 이전 상태로 복구합니다. 복원 작업은 지정된 백업의 데이터를 사용하여 Harbor 인스턴스를 다시 만듭니다. 자세한 내용은 복원 만들기를 참고하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eHarbor backup and restore allows for the creation of both scheduled and manual backups of a Harbor instance, providing protection against data loss and enabling long-term data retention.\u003c/p\u003e\n"],["\u003cp\u003eThe system uses custom resources like \u003ccode\u003eHarborInstanceBackup\u003c/code\u003e, \u003ccode\u003eHarborInstanceBackupRepository\u003c/code\u003e, and \u003ccode\u003eHarborInstanceBackupPlan\u003c/code\u003e to manage backups and define backup schedules and retention policies.\u003c/p\u003e\n"],["\u003cp\u003eBackups include both metadata from the Harbor database and artifact data from object storage, stored in S3-compatible object storage buckets.\u003c/p\u003e\n"],["\u003cp\u003eWrite operations to Harbor are restricted during a backup to ensure data consistency, this includes editing configurations, creating projects, or pushing artifacts.\u003c/p\u003e\n"],["\u003cp\u003eThe restore process mirrors the backup architecture, allowing a Harbor instance to be recovered to a previous state using a selected backup.\u003c/p\u003e\n"]]],[],null,["# Overview\n\nThis page provides an overview of Harbor backup and restore operations.\n\nHarbor backup and restore lets you create backups of your Harbor instance and\nrestore that instance in the case of a disaster. Harbor instance backups offer\nthe following benefits:\n\n- **Protect against data loss:** Create scheduled or manual backups to capture your data at a specific point in time.\n- **Long-term retention and archiving:** Use retention policies for long-term data retention and archiving, enabling you to meet regulatory compliance requirements and preserve historical data.\n- **Data consistency:** The backup operation handles the necessary Harbor quiesce and unquiesce steps to ensure data consistency.\n\nFeatures overview\n-----------------\n\nHarbor backup and restore has the following features:\n\n- Set Harbor instances to back up automatically at a scheduled time.\n- Create manual backups on your Harbor instances on-demand to capture your Harbor instances in the exact chosen state.\n- Deploy retention policies to dictate when old backups get deleted and which backups are retained.\n- Restore the Harbor instance from a previously created backup.\n\nTo maintain data consistency, you can't perform write operations to Harbor while a backup is in progress. This restriction includes editing Harbor configurations, creating new Harbor instance projects, and pushing artifacts. For more information, see the Harbor documentation: \u003chttps://goharbor.io/docs/main/administration/backup-restore/#backup-harbor-instance\u003e.\n\nArchitecture overview\n---------------------\n\nHarbor backup and restore leverages existing GDC backup and restore\narchitecture. The system is a distributed backup solution designed for\nKubernetes environments consisting of the following components:\n\n- Custom resources define and manage backups.\n- Backups target both database and artifact registry data sources in object storage.\n- System design addresses high availability and disaster recovery considerations.\n\nThe Harbor backup and restore system consists of the following components:\n\n1. A `HarborInstanceBackup` custom resource is the entry point to interact with the system. This custom resource points to a set of controllers used to reconcile Harbor backup objects. The system uses the `HarborInstanceBackup` resource to create both manual backups that you create, and automatic backups that are created according to backup plan schedule.\n2. The system uses this set of controllers to reconcile the Harbor backup objects:\n 1. The `HarborInstanceBackupRepository` controller monitors the `HarborInstanceBackupRepository` custom resource. The resource represents a backup storage target to reference in `HarborInstanceBackupPlan` and `HarborInstanceBackup`.\n 2. The `HarborInstanceBackupPlan` controller monitors the `HarborInstanceBackupPlan` custom resource, which creates `HarborInstanceBackup` custom resources to the given Harbor instance according to the provided schedule and retention configuration.\n 3. The `HarborInstanceBackup` controller monitors the `HarborInstanceBackup` custom resource to manage the two different backup flows for the persistent data sources of a single Harbor instance. These data sources are metadata in the Harbor database and artifact data in registry object storage.\n3. The system stores backups in S3-compatible objects storage buckets.\n\nThe restore architecture mirrors the design of the backup system.\n\nCreate a backup repository\n--------------------------\n\nHarbor backup repository represents an S3-compatible storage location for your backups. Harbor instances, which manage container images essential for software deployment, require secure and reliable backup mechanisms. For more information, see [Create a backup\nrepository](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/create-backup-repository-harbor).\n\nCreate backup plans\n-------------------\n\nHarbor backup plans provide the configuration, location, and management\nfunctions for Harbor instance backups. Use backup plans to create scheduled\nautomatic backups. For more information, see [Create a backup\nplan](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/create-backup-plan-harbor).\n\nCreate manual backups\n---------------------\n\nHarbor backups contain your Harbor instance data. With backup plans, backups\nare created on a schedule that you define. You can also create manual backup on\ndemand. For more information, see [Create a manual\nbackup](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/create-manual-backup-harbor).\n\nRestore a backup\n----------------\n\nRestore a backup of a Harbor instance in GDC.\nRecover your Harbor instance to a previous state using an existing backup. The\nrestore operation uses the data from the specified backup to recreate the Harbor\ninstance. For more information, see [Create a\nrestore](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/create-restore-harbor).\n\nWhat's next\n-----------\n\n- [Create a backup repository](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/create-backup-repository-harbor)"]]
