Melakukan pemulihan file selektif

Halaman ini menjelaskan cara melakukan pemulihan file selektif.

Sebelum memulai

Tinjau prasyarat berikut sebelum Anda melakukan pemulihan file selektif:

• Konfigurasi snapshot: direktori snapshot volume target tempat pemulihan dimulai harus terlihat. Di halaman Create new volume from backup, pilih kotak centang Make snapshot directory visible. Untuk mengetahui informasi selengkapnya, lihat Membuat volume baru.

• Versi Google Cloud CLI: untuk mengakses pemulihan file selektif, pastikan versi Google Cloud CLI Anda minimal 540.0.0.

  Untuk memverifikasi dan mengupdate versi Google Cloud CLI:

  1. Periksa versi Google Cloud CLI Anda:

     gcloud --version
     

  2. Jika versi Google Cloud CLI Anda lebih lama dari 540.0.0, update:

     gcloud components update
     

Melakukan pemulihan file selektif

Anda dapat menggunakan pemulihan file selektif untuk memulihkan file dengan cara berikut:

• Pulihkan file ke volume sumber dan direktori sumber yang sama.

• Memulihkan file ke volume sumber di direktori yang berbeda.

• Pulihkan file ke volume baru di direktori pilihan Anda.

Pemulihan file selektif mendukung pencadangan dalam region dan lintas region. Prosedur ini menjelaskan tiga kasus yang berbeda:

• Pemulihan dalam region ke volume sumber di direktori sumber yang sama.

• Pemulihan lintas-region ke volume baru.

• Pemulihan di tempat ke volume baru.

Kasus 1: Pemulihan dalam region ke volume sumber di direktori sumber yang sama

Gunakan petunjuk berikut untuk melakukan pemulihan file selektif dalam region menggunakan Google Cloud CLI.

gcloud

Untuk melakukan pemulihan file selektif:

gcloud netapp volumes restore-backup-files DESTINATION_VOLUME_NAME \
  --location=LOCATION --project=PROJECT_ID \
  --backup=projects/PROJECT_ID/locations/LOCATION/backupVaults/VAULT_NAME/backups/BACKUP_NAME \
  --file-list=FILE_LIST \
  --restore-destination-path=RESTORE_DESTINATION_PATH

Ganti informasi berikut:

• DESTINATION_VOLUME_NAME: nama volume tujuan untuk operasi pemulihan. Volume ini dapat berupa volume asli tempat cadangan diambil atau volume baru.

• LOCATION: region tempat volume berada.

• PROJECT_ID: ID project tempat volume dan storage pool dibuat.

• VAULT_NAME: nama vault cadangan. Vault pencadangan dalam region dan lintas region didukung.

• BACKUP_NAME: nama cadangan yang berisi file yang akan dipulihkan.

• FILE_LIST: daftar jalur file yang dipisahkan koma dalam cadangan yang dipilih yang perlu dipulihkan.

• RESTORE_DESTINATION_PATH: Opsional: jalur tertentu tempat file akan dipulihkan. Jika tidak ada jalur yang diberikan dalam parameter ini, pemulihan di tempat akan dilakukan.

  Catatan: Untuk parameter --file-list, tentukan jalur sumber file dari root titik pemasangan. Terlepas dari apakah protokol SMB atau NFS digunakan, jalur untuk file sumber dan tujuan harus mengikuti representasi UNIX.

Contoh:

Pertimbangkan operasi pemulihan file selektif yang dilakukan pada cadangan volume sumber bernama sfr-demo-vol-1. Volume sumber ini dicadangkan ke sfr-demo-backup-1 dalam brankas cadangan bernama sfr-demo-vault-in-region.

Volume sumber berisi tiga file teks:

• 1.txt

• 2.txt

• directory/3.txt

Cadangan, sfr-demo-backup-1, telah diidentifikasi dalam brankas cadangan dalam region. File directory/3.txt dan direktori induknya dihapus dari volume sumber. Kemudian, operasi pemulihan dilakukan dengan parameter tertentu.

File directory/3.txt dari sfr-demo-backup-1 akan dipulihkan ke volume sumber.

Penting: Sebelum menjalankan operasi pemulihan, pastikan direktori tujuan directory dibuat di volume sumber. Jika tidak, operasi pemulihan akan gagal.

Pulihkan file:

gcloud netapp volumes restore-backup-files sfr-demo-vol-1
--location=us-central1 --project=my-project
--backup=projects/my-project/locations/us-central1/backupVaults/sfr-demo-vault-in-region/backups/sfr-demo-backup-1
--file-list=/directory/3.txt --restore-destination-path=/directory/

Anda akan diminta untuk mengonfirmasi operasi pemulihan:

You are about to restore files from a backup to Volume
projects/my-project/locations/us-central1/volumes/sfr-demo-vol-1.
Are you sure?

Do you want to continue (Y/n)? Y

Operasi berhasil diselesaikan:

Waiting for [operation-1758048175178-63eef7cfac198-a94afb9b-913b60d5] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.RestoreBackupFilesResponse

Kasus 2: Pemulihan lintas region ke volume baru dalam direktori baru

Gunakan petunjuk berikut untuk melakukan pemulihan file selektif lintas region menggunakan Google Cloud CLI.

gcloud

Untuk melakukan pemulihan file selektif:

gcloud netapp volumes restore-backup-files DESTINATION_VOLUME_NAME \
  --location=LOCATION --project=PROJECT_ID \
  --backup=projects/PROJECT_ID/locations/LOCATION/backupVaults/VAULT_NAME/backups/BACKUP_NAME \
  --file-list=FILE_LIST \
  --restore-destination-path=RESTORE_DESTINATION_PATH

Ganti informasi berikut:

• DESTINATION_VOLUME_NAME: nama volume tujuan untuk operasi pemulihan. Volume ini dapat berupa volume asli tempat cadangan diambil atau volume baru.

• LOCATION: region tempat volume berada.

• PROJECT_ID: ID project tempat volume dan storage pool dibuat.

• VAULT_NAME: nama vault cadangan. Vault pencadangan dalam region dan lintas region didukung.

• BACKUP_NAME: nama cadangan yang berisi file yang akan dipulihkan.

• FILE_LIST: daftar jalur file yang dipisahkan koma dalam cadangan yang dipilih yang perlu dipulihkan.

• RESTORE_DESTINATION_PATH: Opsional: jalur tertentu tempat file akan dipulihkan. Jika tidak ada jalur yang diberikan dalam parameter ini, pemulihan di tempat akan dilakukan.

  Catatan: Untuk parameter --file-list, tentukan jalur sumber file dari root titik pemasangan. Terlepas dari apakah protokol SMB atau NFS digunakan, jalur untuk file sumber dan tujuan harus mengikuti representasi UNIX.

Contoh:

Pertimbangkan operasi pemulihan file selektif yang dilakukan pada cadangan volume sumber bernama sfr-demo-vol-2. Volume sumber ini dicadangkan ke sfr-demo-backup dalam brankas cadangan bernama sfr-demo-vault-cross-region.

Volume sumber berisi dua file teks:

• 1.txt

• 2.txt

Cadangan, sfr-demo-backup, telah diidentifikasi di brankas pencadangan lintas region, dengan us-central1 sebagai region sumber dan us-east4 sebagai region tujuan. Setelah cadangan dibuat, file 1.txt dihapus dari volume sumber.

File 1.txt dari sfr-demo-backup akan dipulihkan ke volume baru bernama sfr-demo-vol-3 di direktori baru bernama test.

Penting: Sebelum menjalankan operasi pemulihan, pastikan direktori tujuan test dibuat di volume baru sfr-demo-vol-3. Jika tidak, operasi pemulihan akan gagal.

Pulihkan file:

gcloud netapp volumes restore-backup-files sfr-demo-vol-3
--location=us-central1 --project=my-project
--backup=projects/my-project/locations/us-central1/backupVaults/sfr-demo-vault-cross-region/backups/sfr-demo-backup
--file-list=/1.txt --restore-destination-path=/test

Anda akan diminta untuk mengonfirmasi operasi pemulihan:

You are about to restore files from a backup to Volume
projects/my-project/locations/us-central1/volumes/sfr-demo-vol-3.
Are you sure?

Do you want to continue (Y/n)? Y

Setelah konfirmasi, operasi berhasil.

Waiting for [operation-1758050930422-63ef02134743f-8761c12f-b05a405e] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.RestoreBackupFilesResponse

Kasus 3: Pemulihan di tempat ke volume baru

Gunakan petunjuk berikut untuk melakukan pemulihan file selektif di tempat menggunakan Google Cloud CLI.

gcloud

Untuk melakukan pemulihan file selektif:

gcloud netapp volumes restore-backup-files DESTINATION_VOLUME_NAME \
  --location=LOCATION --project=PROJECT_ID \
  --backup=projects/PROJECT_ID/locations/LOCATION/backupVaults/VAULT_NAME/backups/BACKUP_NAME \
  --file-list=FILE_LIST

Ganti informasi berikut:

• DESTINATION_VOLUME_NAME: nama volume tujuan untuk operasi pemulihan. Volume ini dapat berupa volume asli tempat cadangan diambil atau volume baru.

• LOCATION: region tempat volume berada.

• PROJECT_ID: ID project tempat volume dan storage pool dibuat.

• VAULT_NAME: nama vault cadangan. Vault pencadangan dalam region dan lintas region didukung.

• BACKUP_NAME: nama cadangan yang berisi file yang akan dipulihkan.

• FILE_LIST: daftar jalur file yang dipisahkan koma dalam cadangan yang dipilih yang perlu dipulihkan.

  Catatan: Untuk parameter --file-list, tentukan jalur sumber file dari root titik pemasangan. Terlepas dari apakah protokol SMB atau NFS digunakan, jalur untuk file sumber dan tujuan harus mengikuti representasi UNIX.

Contoh:

Pertimbangkan operasi pemulihan file selektif yang dilakukan pada cadangan volume sumber bernama sfr-demo-vol-2. Volume sumber ini dicadangkan ke sfr-demo-backup dalam brankas cadangan bernama sfr-demo-vault-cross-region.

Volume sumber berisi dua file teks:

• 1.txt

• 2.txt

Cadangan, sfr-demo-backup, telah diidentifikasi di brankas pencadangan lintas region, dengan us-central1 sebagai region sumber dan us-east4 sebagai region tujuan. Setelah cadangan dibuat, file 1.txt dihapus dari volume sumber.

File 1.txt dari sfr-demo-backup akan dipulihkan ke volume baru bernama sfr-demo-vol-3, tetapi direktori untuk operasi pemulihan tidak akan ditentukan.

Penting: Sebelum menjalankan pemulihan di tempat, pastikan volume tujuan sfr-demo-vol-3 memiliki direktori yang sama persis dengan tempat file awalnya dicadangkan.

Pulihkan file:

gcloud netapp volumes restore-backup-files sfr-demo-vol-3
--location=us-central1 --project=my-project
--backup=projects/my-project/locations/us-central1/backupVaults/sfr-demo-vault-cross-region/backups/sfr-demo-backup
--file-list=/1.txt

Anda akan diminta untuk mengonfirmasi operasi pemulihan:

You are about to restore files from a backup to Volume
projects/my-project/locations/us-central1/volumes/sfr-demo-vol-3.
Are you sure?

Do you want to continue (Y/n)? Y

Setelah konfirmasi, operasi berhasil.

Waiting for [operation-1758875604584-63fb0239d87b7-1035ba74-caed1838] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.RestoreBackupFilesResponse