Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan cara membuat cadangan manual, melihat cadangan yang ada, dan menghapus cadangan yang ada untuk workload cluster di Google Distributed Cloud (GDC) yang terisolasi.
Sebelum memulai
Untuk membuat, melihat, dan menghapus cadangan, Anda harus memiliki hal berikut:
Peran akses dan identitas yang diperlukan:
Untuk pengguna Administrator Platform (PA):
Admin Pencadangan Cluster Pengguna: mengelola resource pencadangan seperti rencana pencadangan dan pemulihan di cluster pengguna. Minta Admin IAM Organisasi Anda untuk memberi Anda peran User Cluster Backup Admin (user-cluster-backup-admin).
Untuk pengguna Operator Aplikasi (AO):
Pembuat Cadangan: membuat cadangan dan pemulihan manual. Minta Admin IAM Project Anda untuk memberi Anda peran Pembuat Cadangan (backup-creator).
Untuk mengetahui informasi selengkapnya, lihat Definisi peran.
Pengguna AO hanya dapat melakukan pencadangan manual dari paket pencadangan yang ada.
Buat cadangan manual
Jika rencana cadangan Anda menentukan jadwal untuk pencadangan, cadangan akan
otomatis dibuat sesuai jadwal tersebut. Anda juga dapat membuat cadangan secara manual di luar cakupan jadwal rencana pencadangan. Misalnya, Anda mungkin ingin mencadangkan workload sebelum mengupgrade aplikasi. Pencadangan tidak
mencakup informasi konfigurasi cluster, seperti konfigurasi node, kumpulan
node, ukuran cluster awal, atau fitur yang diaktifkan.
Ada dua jenis data yang disalin dalam cadangan:
Cadangan konfigurasi: Kumpulan deskripsi resource Kubernetes yang diekstrak dari
server API cluster yang sedang dicadangkan.
Cadangan volume: Cadangan PersistentVolumeClaims.
Konsol
Login ke konsol GDC.
Di menu navigasi, klik Backup for Clusters.
Klik tab Rencana Cadangan.
Klik paket yang ingin Anda gunakan untuk pencadangan.
Klik Mulai pencadangan.
Masukkan nama cadangan dan deskripsi opsional.
Tetapkan jumlah hari untuk menyimpan cadangan. Setelah jumlah hari ini tercapai, cadangan akan
otomatis dihapus.
Tetapkan jumlah hari cadangan tidak dapat dihapus.
Klik Mulai.
API
Cadangan manual harus mereferensikan rencana cadangan yang ada untuk konfigurasi cadangan dan cadangan harus dibuat dengan mengeluarkan ManualClusterBackupRequest.
Nama ClusterBackupPlan yang akan digunakan untuk konfigurasi
cadangan. Paket pencadangan harus ada di namespace yang sama dengan
ManualClusterBackupRequest.
deleteLockDays
Mencegah penghapusan cadangan selama jumlah hari yang ditentukan setelah pembuatan cadangan. Tindakan ini akan menggantikan retentionPolicy di
ClusterBackupPlan.
retainDays
Menghapus cadangan setelah jumlah hari yang ditentukan tercapai setelah
pembuatan cadangan. Nilai ini menggantikan retentionPolicy di ClusterBackupPlan.
Kebijakan retensi tidak menggantikan kebijakan retensi lokasi penyimpanan, dan tidak dapat melebihi 90 hari.
Melihat cadangan
Pengguna dengan peran User Cluster Backup Admin (user-cluster-backup-admin) dapat melihat semua cadangan di organisasi.
Pengguna dengan peran Pembuat Cadangan (backup-creator) dapat melihat semua cadangan dalam project.
Konsol
Login ke konsol GDC.
Di menu navigasi, klik Backup for Clusters.
Klik Pilih project untuk memilih organisasi atau project, bergantung pada peran Anda:
Admin Pencadangan Cluster Pengguna: Pilih organisasi untuk melihat semua cadangan dalam organisasi atau pilih project untuk melihat semua cadangan dalam project.
Pembuat Cadangan: Pilih project untuk melihat semua cadangan dalam project.
Klik tab Backups.
Klik cadangan dalam daftar untuk melihat detailnya.
kubectl
Melihat daftar cadangan Anda:
kubectlgetclusterBackups
Contoh output:
NAME STATE
backup-test Succeeded
Menghapus cadangan
Pencadangan tidak dapat dihapus dengan interaksi reguler dengan server Kubernetes API. Untuk menghapus cadangan, gunakan konsol GDC atau keluarkan DeleteClusterBackupRequest.
Konsol
Menghapus cadangan dari tab Cadangan:
Login ke konsol GDC.
Di menu navigasi, klik Backup for Clusters.
Klik Pilih project untuk memilih organisasi atau project, bergantung pada peran Anda:
Admin Pencadangan Cluster Pengguna: Pilih organisasi untuk melihat semua cadangan dalam organisasi, atau pilih project untuk melihat semua cadangan dalam project.
Pembuat Cadangan: Pilih project untuk melihat semua cadangan dalam project.
Klik tab Backups.
Klik ikon menu tiga titik untuk cadangan yang ingin Anda hapus.
Ketik nama cadangan ke dalam kotak teks.
Klik tombol Hapus Cadangan untuk menyelesaikan penghapusan cadangan ini.
Atau, hapus cadangan dengan mengklik nama cadangan saat melihat rencana cadangan:
Login ke konsol GDC.
Di menu navigasi, klik Backup for Clusters.
Klik Pilih project, lalu pilih organisasi atau project, bergantung pada
peran Anda:
Admin Pencadangan Cluster Pengguna: Pilih organisasi untuk melihat semua rencana pencadangan dalam organisasi, atau pilih project untuk melihat semua rencana pencadangan dalam project.
Pembuat Cadangan: Pilih project untuk melihat semua rencana cadangan dalam project.
Klik tab Rencana Cadangan.
Klik nama rencana cadangan yang berisi cadangan yang ingin Anda hapus.
Klik tab Backups.
Klik nama cadangan yang ingin Anda hapus.
Klik tombol Hapus Cadangan.
Masukkan nama cadangan ke dalam kolom teks.
Klik tombol Hapus untuk menyelesaikan penghapusan cadangan ini.
backupName: nama cadangan yang sedang dihapus. Cadangan ini harus ada
di namespace yang sama dengan DeleteClusterBackupRequest.
DeleteClusterBackupRequest: resource yang menghapus resource kustom cadangan dari cluster
dan menghapus semua artefak yang terkait dengan cadangan tersebut dari lokasi
penyimpanan cadangan, termasuk data volume.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eThis page guides users on managing cluster workload backups in Google Distributed Cloud (GDC) air-gapped environments, covering the creation, viewing, and deletion of backups.\u003c/p\u003e\n"],["\u003cp\u003eCreating manual backups can be done through the GDC console or API, referencing an existing backup plan, and users must have appropriate roles, either User Cluster Backup Admin or Backup Creator.\u003c/p\u003e\n"],["\u003cp\u003eUsers can view backups through the GDC console or \u003ccode\u003ekubectl\u003c/code\u003e, with visibility determined by their assigned role: User Cluster Backup Admins can view all backups, while Backup Creators can only see backups within their project.\u003c/p\u003e\n"],["\u003cp\u003eDeleting backups requires using the GDC console or a \u003ccode\u003eDeleteClusterBackupRequest\u003c/code\u003e via API, and it is important to note that deleting backups is an irreversible action.\u003c/p\u003e\n"],["\u003cp\u003eBackups consist of config backup, a set of kubernetes resource descriptions, and volume backup, a backup of PersistentVolumeClaims, but it does not include cluster configurations.\u003c/p\u003e\n"]]],[],null,["# Back up your workloads\n\nThis page details how to create manual backups, view existing backups, and delete existing backups for cluster workloads in Google Distributed Cloud (GDC) air-gapped.\n\nBefore you begin\n----------------\n\nTo create, view, and delete backups, you must have the following:\n\n- The necessary identity and access role:\n\n - For Platform Administrator (PA) users:\n - User Cluster Backup Admin: manages backup resources such as backup and restore plans in user clusters. Ask your Organization IAM Admin to grant you the User Cluster Backup Admin (`user-cluster-backup-admin`) role.\n - For Application Operator (AO) users:\n - Backup Creator: creates manual backups and restores. Ask your Project IAM Admin to grant you the Backup Creator (`backup-creator`) role.\n - For more information, see [Role definitions](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/role-definitions).\n- AO users can only perform manual backups from an existing backup\n plan.\n\nCreate a manual backup\n----------------------\n\nIf your backup plan defines a schedule for the backup, the backups are\nautomatically created according to that schedule. You can also manually create a backup\noutside the scope of your backup plan schedule. For example, you might want to back\nup your workloads before you upgrade your applications. A backup does not\ninclude cluster configuration information, such as node configurations, node\npools, initial cluster size, or what features are enabled.\n\nTwo forms of data are captured in a backup:\n\n- **Config backup**: A set of Kubernetes resource descriptions extracted from the API server of the cluster undergoing backup.\n- **Volume backup** : A backup of `PersistentVolumeClaims`.\n\n### Console\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click the **Backup Plans** tab.\n4. Click the plan that you want to use for the backup.\n5. Click **Start a backup**.\n6. Enter a backup name and an optional description.\n7. Set the number of days to retain the backup. Once this number of days is reached, the backup is automatically deleted.\n8. Set the number of days during which backups cannot be deleted.\n9. Click **Start**.\n\n### API\n\nThe manual backup must reference an existing backup plan for the backup\nconfiguration and the backup must be created by issuing a\n`ManualClusterBackupRequest`.\n\nHere's an example of a `ManualClusterBackupRequest`: \n\n apiVersion: backup.gdc.goog/v1\n kind: ManualClusterBackupRequest\n metadata:\n name: manualbackuprequest-test\n namespace: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003ePROJECT_NAME\u003c/span\u003e\u003c/var\u003e\n spec:\n clusterBackupName: \"backup-test\"\n clusterBackupPlanRef: \"backupplan-test\"\n deleteLockDays: 5\n retainDays: 6\n\nReplace \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e with the name of your GDC project.\n\nThis example includes the following values:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nView a backup\n-------------\n\nUsers with the User Cluster Backup Admin (`user-cluster-backup-admin`) role can see all backups in the organization.\nUsers with the Backup Creator (`backup-creator`) role can see all of the backups in a project. \n\n### Console\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Select project** to select an organization or project depending on your role:\n - User Cluster Backup Admin: Select an organization to see all backups in an organization or select a project to see all backups in a project.\n - Backup Creator: Select a project to see all backups in a project.\n4. Click the **Backups** tab.\n5. Click a backup in the list to view its details.\n\n### kubectl\n\nView a list of your backups: \n\n kubectl get clusterBackups\n\nAn example of the output: \n\n NAME STATE\n backup-test Succeeded\n\nDelete a backup\n---------------\n\nBackups can't be deleted by a regular interaction with the Kubernetes API\nserver. To delete a backup, use the GDC console or issue a `DeleteClusterBackupRequest`. \n\n### Console\n\nDelete the backup from the **Backups** tab:\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Select project** to select an organization or project depending on your role:\n - User Cluster Backup Admin: Select an organization to see all backups in an organization, or select a project to see all backups in a project.\n - Backup Creator: Select a project to see all backups in a project.\n4. Click the **Backups** tab.\n5. Click the three-dot menu icon for the backup you want to delete.\n6. Type the name of the backup into the text box.\n7. Click the **Delete Backup** button to complete the deletion of this backup.\n\n | **Note:** This operation can't be undone.\n\nAlternatively, delete the backup by clicking on the backup name when viewing a backup plan:\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Select project** , and select an organization or project depending on your role:\n - User Cluster Backup Admin: Select an organization to see all of the backup plans in an organization, or select a project to see all of the backup plans in a project.\n - Backup Creator: Select a project to see all of the backup plans in a project.\n4. Click the **Backup Plans** tab.\n5. Click the name of the backup plan containing the backup you want to delete.\n6. Click the **Backups** tab.\n7. Click the name of the backup you want to delete.\n8. Click the **Delete Backup** button.\n9. Enter the name of the backup into the text field.\n10. Click the **Delete** button to complete the deletion of this backup.\n\n | **Note:** This operation can't be undone.\n\n### kubectl\n\nSend a `DeleteClusterBackupRequest` request: \n\n apiVersion: backup.gdc.goog/v1\n kind: DeleteClusterBackupRequest\n metadata:\n name: deletebackuprequest-test\n namespace: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003ePROJECT_NAME\u003c/span\u003e\u003c/var\u003e\n spec:\n clusterBackupRef: \"backup-test\"\n\nReplace \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e with the name of your GDC project.\n\nThis example includes the following values:\n\n- `backupName`: the name of the backup being deleted. This backup must exist in the same namespace as the `DeleteClusterBackupRequest`.\n- `DeleteClusterBackupRequest`: the resource that deletes the backup custom resource from the cluster and removes all artifacts associated with that backup from the storage location of the backup, including volume data.\n\n| **Note:** Attempting to delete a `ClusterBackup` resource without applying a `DeleteClusterBackupRequest` resource doesn't clean object storage artifacts and might result in undefined behavior.\n\nWhat's next\n-----------\n\n- [Plan a set of restores](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/cluster-backup/plan-restores)"]]
