선택적 파일 복원 실행

이 페이지에서는 선택적 파일 복원을 실행하는 방법을 설명합니다.

시작하기 전에

선택적 파일 복원을 실행하기 전에 다음 기본 요건을 검토하세요.

  • 스냅샷 구성: 복원이 시작되는 타겟 볼륨의 스냅샷 디렉터리가 표시되어야 합니다. 백업에서 새 볼륨 만들기 페이지에서 스냅샷 디렉터리 표시 체크박스를 선택합니다. 자세한 내용은 새 볼륨 만들기를 참고하세요.

  • Google Cloud CLI 버전: 선택적 파일 복원에 액세스하려면 Google Cloud CLI 버전이 540.0.0 이상이어야 합니다.

    Google Cloud CLI 버전을 확인하고 업데이트하려면 다음을 실행합니다.

    1. Google Cloud CLI 버전을 확인합니다.

      gcloud --version
      
    2. Google Cloud CLI 버전이 540.0.0보다 오래된 경우 업데이트합니다.

      gcloud components update
      

선택적 파일 복원 실행

선택적 파일 복원을 사용하여 다음과 같은 방법으로 파일을 복구할 수 있습니다.

  • 파일을 소스 볼륨과 동일한 소스 디렉터리로 복원합니다.

  • 다른 디렉터리의 소스 볼륨으로 파일을 복원합니다.

  • 원하는 디렉터리의 새 볼륨으로 파일을 복원합니다.

선택적 파일 복원은 리전 내 백업과 리전 간 백업을 모두 지원합니다. 이 절차에서는 세 가지 다른 사례를 설명합니다.

사례 1: 동일한 소스 디렉터리의 소스 볼륨에 리전 내 복원

다음 안내에 따라 Google Cloud CLI를 사용하여 리전 내 선택적 파일 복원을 실행합니다.

gcloud

선택적 파일 복원을 실행하려면 다음 단계를 따르세요.

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

다음 정보를 바꿉니다.

  • DESTINATION_VOLUME_NAME: 복원 작업의 대상 볼륨 이름입니다. 백업이 생성된 원래 볼륨이거나 새 볼륨일 수 있습니다.

  • LOCATION: 볼륨이 있는 리전입니다.

  • PROJECT_ID: 볼륨과 스토리지 풀이 생성된 프로젝트의 ID입니다.

  • VAULT_NAME: Backup Vault 이름 리전 내 및 리전 간 Backup Vault가 모두 지원됩니다.

  • BACKUP_NAME: 복원할 파일이 포함된 백업의 이름입니다.

  • FILE_LIST: 선택한 백업에서 복원해야 하는 파일 경로의 쉼표로 구분된 목록입니다.

  • RESTORE_DESTINATION_PATH: (선택사항) 파일이 복원될 특정 경로입니다. 이 매개변수에 경로가 제공되지 않으면 현재 위치 복원이 실행됩니다.

예:

sfr-demo-vol-1이라는 소스 볼륨의 백업에서 실행되는 선택적 파일 복원 작업을 고려해 보세요. 이 소스 볼륨은 sfr-demo-vault-in-region이라는 Backup Vault 내의 sfr-demo-backup-1에 백업됩니다.

소스 볼륨에는 다음과 같은 3개의 텍스트 파일이 포함되어 있습니다.

  • 1.txt

  • 2.txt

  • directory/3.txt

리전 내 Backup Vault에서 sfr-demo-backup-1 백업이 확인되었습니다. directory/3.txt 파일과 상위 디렉터리가 소스 볼륨에서 삭제됩니다. 그런 다음 특정 매개변수로 복원 작업이 실행됩니다.

sfr-demo-backup-1의 파일 directory/3.txt이 소스 볼륨에 복원됩니다.

파일을 복원합니다.

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/

복원 작업을 확인하라는 메시지가 표시됩니다.

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

작업이 성공적으로 완료됩니다.

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

케이스 2: 새 디렉터리의 새 볼륨으로 교차 리전 복원

다음 안내에 따라 Google Cloud CLI를 사용하여 교차 리전 선택적 파일 복원을 실행합니다.

gcloud

선택적 파일 복원을 실행하려면 다음 단계를 따르세요.

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

다음 정보를 바꿉니다.

  • DESTINATION_VOLUME_NAME: 복원 작업의 대상 볼륨 이름입니다. 백업이 생성된 원래 볼륨이거나 새 볼륨일 수 있습니다.

  • LOCATION: 볼륨이 있는 리전입니다.

  • PROJECT_ID: 볼륨과 스토리지 풀이 생성된 프로젝트의 ID입니다.

  • VAULT_NAME: Backup Vault 이름 리전 내 및 리전 간 Backup Vault가 모두 지원됩니다.

  • BACKUP_NAME: 복원할 파일이 포함된 백업의 이름입니다.

  • FILE_LIST: 선택한 백업에서 복원해야 하는 파일 경로의 쉼표로 구분된 목록입니다.

  • RESTORE_DESTINATION_PATH: (선택사항) 파일이 복원될 특정 경로입니다. 이 매개변수에 경로가 제공되지 않으면 현재 위치 복원이 실행됩니다.

예:

sfr-demo-vol-2이라는 소스 볼륨의 백업에서 실행되는 선택적 파일 복원 작업을 고려해 보세요. 이 소스 볼륨은 sfr-demo-vault-cross-region이라는 Backup Vault 내의 sfr-demo-backup에 백업됩니다.

소스 볼륨에는 다음 두 개의 텍스트 파일이 포함되어 있습니다.

  • 1.txt

  • 2.txt

us-central1을 소스 리전으로, us-east4을 대상 리전으로 하는 리전 간 백업 보관소에서 sfr-demo-backup 백업이 확인되었습니다. 백업이 생성된 후 1.txt 파일이 소스 볼륨에서 삭제되었습니다.

sfr-demo-backup1.txt 파일이 test이라는 새 디렉터리의 sfr-demo-vol-3라는 새 볼륨으로 복원됩니다.

파일을 복원합니다.

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

복원 작업을 확인하라는 메시지가 표시됩니다.

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

확인 후 작업이 성공합니다.

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

케이스 3: 새 볼륨으로 인플레이스 복원

다음 안내에 따라 Google Cloud CLI를 사용하여 인플레이스 선택적 파일 복원을 실행하세요.

gcloud

선택적 파일 복원을 실행하려면 다음 단계를 따르세요.

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

다음 정보를 바꿉니다.

  • DESTINATION_VOLUME_NAME: 복원 작업의 대상 볼륨 이름입니다. 백업이 생성된 원래 볼륨이거나 새 볼륨일 수 있습니다.

  • LOCATION: 볼륨이 있는 리전입니다.

  • PROJECT_ID: 볼륨과 스토리지 풀이 생성된 프로젝트의 ID입니다.

  • VAULT_NAME: Backup Vault 이름 리전 내 및 리전 간 Backup Vault가 모두 지원됩니다.

  • BACKUP_NAME: 복원할 파일이 포함된 백업의 이름입니다.

  • FILE_LIST: 선택한 백업에서 복원해야 하는 파일 경로의 쉼표로 구분된 목록입니다.

예:

sfr-demo-vol-2이라는 소스 볼륨의 백업에서 실행되는 선택적 파일 복원 작업을 고려해 보세요. 이 소스 볼륨은 sfr-demo-vault-cross-region이라는 Backup Vault 내의 sfr-demo-backup에 백업됩니다.

소스 볼륨에는 다음 두 개의 텍스트 파일이 포함되어 있습니다.

  • 1.txt

  • 2.txt

us-central1을 소스 리전으로, us-east4을 대상 리전으로 하는 리전 간 백업 보관소에서 sfr-demo-backup 백업이 확인되었습니다. 백업이 생성된 후 1.txt 파일이 소스 볼륨에서 삭제되었습니다.

sfr-demo-backup1.txt 파일이 sfr-demo-vol-3라는 새 볼륨으로 복원되지만 복원 작업의 디렉터리는 지정되지 않습니다.

파일을 복원합니다.

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

복원 작업을 확인하라는 메시지가 표시됩니다.

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

확인 후 작업이 성공합니다.

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