이 페이지에서는 Google Distributed Cloud (GDC) 에어 갭에서 Harbor 인스턴스의 백업 계획을 만드는 방법을 설명합니다.
백업 계획은 백업된 Harbor 인스턴스를 참조합니다. 백업 계획은 백업 일정, 보관 정책과 같은 백업의 주요 구성요소를 정의합니다. GDC는 백업 계획에 제공된 구성에 따라 백업을 자동으로 생성합니다. 주문형 수동 백업을 만들어 백업 계획의 일부 값을 상속할 수도 있습니다.
시작하기 전에
백업 계획을 만들려면 다음 항목에 액세스할 수 있어야 합니다.
필요한 ID 및 액세스 역할:
Harbor 인스턴스 관리자: 프로젝트에서 Harbor 인스턴스를 관리할 수 있는 전체 액세스 권한이 있습니다. 조직 IAM 관리자에게 Harbor 인스턴스 관리자 (harbor-instance-admin) 역할을 부여해 달라고 요청하세요.
Secret Admin: GDC 콘솔에서 작동하는 데 필요합니다. 조직 IAM 관리자에게 보안 비밀 관리자 (secret-admin) 역할을 부여해 달라고 요청하세요.
INSTANCE_NAMESPACE: Harbor 인스턴스를 포함하는 네임스페이스입니다. 백업 계획은 Harbor 인스턴스와 동일한 네임스페이스에 있어야 합니다.
CRON_STRING: 백업 일정을 정의하는 cron 값입니다. 예를 들어 값 0 3 * * *는 매일 오전 3시에 백업을 실행하는 일정을 정의합니다. paused 필드를 사용하여 일정을 일시중지합니다. true인 경우 주기적으로 예약된 백업이 중지됩니다. 일시중지된 백업 계획은 여전히 수동 백업을 만들 수 있습니다.
BACKUP_REPO_NAME: 백업 저장소의 이름입니다. 자세한 내용은 백업 저장소 만들기를 참고하세요.
[[["이해하기 쉬움","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\u003eThis page guides you through creating backup plans for Harbor instances within Google Distributed Cloud (GDC) air-gapped environments.\u003c/p\u003e\n"],["\u003cp\u003eBackup plans define the schedule and retention policy for automatic backups of a specific Harbor instance, with a minimum interval of 10 minutes between backups.\u003c/p\u003e\n"],["\u003cp\u003eCreating a backup plan requires the Harbor Instance Admin and Secret Admin roles, as well as a pre-configured Harbor backup repository.\u003c/p\u003e\n"],["\u003cp\u003eYou can set up the backup plan via the GDC console by selecting the zone, Harbor instance, backup repository, and setting the desired schedule and retention period, or through the API using a YAML configuration file.\u003c/p\u003e\n"],["\u003cp\u003eAutomatic backup deletion can be enabled to remove backups after a set number of days, although this retention policy can be overridden by manual backups.\u003c/p\u003e\n"]]],[],null,["# Create a backup plan\n\nThis page provides instructions for how to create backup plans for Harbor\ninstances in Google Distributed Cloud (GDC) air-gapped.\n\nThe backup plan references the Harbor instance that is backed up. Backup plans\ndefine key components for backups such as the backup schedule and the retention\npolicy. GDC creates backups automatically depending on the configuration you\nprovide in the backup plan. You can also create a manual backup on demand, which\ninherits some values from the backup plan.\n\nBefore you begin\n----------------\n\nTo create a backup plan, you must have access to the following:\n\n- The necessary identity and access roles:\n\n - Harbor Instance Admin: has full access to manage Harbor instances in a project. Ask your Organization IAM Admin to grant you the Harbor Instance Admin (`harbor-instance-admin`) role.\n - Secret Admin: required for operating in the GDC console. Ask your Organization IAM Admin to grant you the Secret Admin (`secret-admin`) role.\n- A Harbor backup repository. For more information, see [Create a backup repository](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/create-backup-repository-harbor).\n\nCreate a backup plan\n--------------------\n\nCreate a repository in the GDC console or the API. \n\n### Console\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for harbor instance**.\n3. Click **Backup plans**.\n4. Click **Create backup plan**.\n5. In the **Zone** menu, select the zone.\n6. In the **Harbor instance source** menu, select the harbor instance this backup plan creates backups for.\n7. In the **Backup plan name** field, enter a name for the backup plan.\n8. Optional: In the **Backup plan description** field, enter a description to distinguish this backup plan from others\n9. In the **Backup repository** menu, select a backup repository from the available options. If there are no options available, you must [Create a\n backup repository](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/create-backup-repository-harbor).\n10. Click **Next**.\n11. In the **Cron string** field, define a schedule for this backup plan. Enter an expression using standard cron syntax. For example, the expression `10 3 * * *` creates a backup at `0310` every day. All times are interpreted as UTC. The minimum interval between scheduled backups is 10 minutes.\n12. Optional: In the **Retention policy** section, decide whether to\n automatically delete backups after a certain number of days:\n\n 1. Select the **Enable automatic backup deletion** checkbox.\n 2. In the **Delete backups** **after** field, set the number of days for which to retain the backup. Once the number of days is reached, the backup is automatically deleted.\n13. Click **Next**.\n\n14. Review the backup plan details. To finalize the creation of this backup\n plan, click **Create Plan**.\n\n### API\n\n apiVersion: artifactregistry.gdc.goog/v1\n kind: HarborInstanceBackupPlan\n metadata:\n name: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eBACKUP_PLAN_NAME\u003c/span\u003e\u003c/var\u003e\n namespace: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eINSTANCE_NAMESPACE\u003c/span\u003e\u003c/var\u003e\n spec:\n backupSchedule:\n cronSchedule: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eCRON_STRING\u003c/span\u003e\u003c/var\u003e\n paused: false\n backupConfig:\n backupRepository: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eBACKUP_REPO_NAME\u003c/span\u003e\u003c/var\u003e\n backupScope:\n harborInstance: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eINSTANCE_NAME\u003c/span\u003e\u003c/var\u003e\n retentionPolicy:\n backupRetainDays: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eBACKUP_RETAIN_DAYS\u003c/span\u003e\u003c/var\u003e\n description: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003ePLAN_DESCRIPTION\u003c/span\u003e\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eBACKUP_PLAN_NAME\u003c/var\u003e: the name of the backup plan.\n- \u003cvar translate=\"no\"\u003eINSTANCE_NAMESPACE\u003c/var\u003e: the namespace containing the Harbor instance. The backup plan must be in the same namespace as the Harbor instance.\n- \u003cvar translate=\"no\"\u003eCRON_STRING\u003c/var\u003e: the cron value that defines the backup schedule. For example the value `0 3 * * *` defines a schedule that performs daily backups at 3 AM. Use the `paused` field to pause the schedule. If true, periodic scheduled backups are stopped. A paused backup plan is still able to create a manual backup.\n- \u003cvar translate=\"no\"\u003eBACKUP_REPO_NAME\u003c/var\u003e: the name of the backup repository. For more information, see [Create a backup repository](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/create-backup-repository-harbor).\n- \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e: the name of the Harbor instance. For more information, see [Create Harbor registry instances](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/create-harbor-instances).\n- \u003cvar translate=\"no\"\u003eBACKUP_RETAIN_DAYS\u003c/var\u003e: the number of days after which the backup is deleted. This value is overridden by manual backups that use this plan.\n- \u003cvar translate=\"no\"\u003ePLAN_DESCRIPTION\u003c/var\u003e: a text description of the backup plan.\n\nWhat's next\n-----------\n\n- [Manage a backup plan](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/manage-backup-plan-harbor)\n- [Create a manual backup](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/create-manual-backup-harbor)\n- [Create a restore](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/harbor-backup/create-restore-harbor)"]]
