Azure Files CSI 드라이버 볼륨 스냅샷 복원

1. 개요

Azure Files CSI 드라이버(file.csi.azure.com)를 사용하여 Kubernetes 환경에서 PV(Persistent Volume)에 연결된 Azure Files 스토리지를 운영하는 경우, 볼륨 스냅샷 생성은 지원되지만, 볼륨 단위 복원은 지원하지 않는 제한이 있습니다.
이 문서는 해당 제한 사항과 권장 운영 방법을 설명합니다.

2. 환경 예시

• Kubernetes 환경: AKS 또는 설치형(Rancher, etc.)
• 스토리지 타입: Azure Files (SMB 또는 NFS 기반)
• CSI 드라이버: file.csi.azure.com
• 백업 툴 예시: Velero, NetBackup 등

3. 지원 범위

4. 발생 가능한 오류 예시

복원 시 다음과 같은 메시지가 출력될 수 있습니다:

rpc error: code = InvalidArgument desc = copy volume from volumeSnapshot is not supported

또는

No volume ID returned by volume snapshotter for persistent volume

5. 원인

• Azure Files 기반 PV에는 DiskName, VolumeHandle 등의 볼륨 식별자가 없어 CSI의 볼륨 복원 로직이 동작하지 않음
• SMB/NFS 기반 스냅샷은 파일 단위 복원 구조로 설계되어 있음
• 현재 Velero 및 일부 백업 솔루션에서는 Azure Files PV 볼륨 복원 기능이 구현되지 않음

6. 운영 권장 사항

6.1 볼륨 단위 복원이 필요한 경우

• Azure Managed Disk CSI 드라이버 사용
  → VolumeSnapshot 생성 및 PVC 복원 지원
  → 블록 스토리지 기반, 전체 볼륨을 신속히 복원 가능

6.2 Azure Files 사용 지속 시

• 복원 작업은 파일·디렉토리 단위로 수행
• 스냅샷에서 필요한 데이터만 복원하는 절차를 마련
• 자동화 스크립트를 작성하여 SMB/NFS 스냅샷 → 특정 경로 복원 처리

6.3 백업 솔루션 활용

• 사용 중인 백업 솔루션(NetBackup, Velero 등)의 Azure Files 볼륨 복원 기능 구현 여부 확인
• Velero GitHub 이슈/PR 상태 모니터링 (azurefile-csi-driver 관련 기능 진행 상황)

7. 절차 예시 (파일 단위 복원)

1. SMB/NFS 스냅샷 생성


   kubectl create -f volumesnapshot.yaml
   

2. az storage file copy 또는 rsync 등을 사용하여 복원 대상 PVC로 복사

8. 참고 URL

• Azure Files CSI Driver GitHub: https://github.com/kubernetes-sigs/azurefile-csi-driver
• Azure Disk CSI Driver GitHub: https://github.com/kubernetes-sigs/azuredisk-csi-driver
• Velero Azure Plugin 이슈: https://github.com/vmware-tanzu/velero/issues/3151