5.4. CSI 볼륨 스냅샷

1. 다음 YAML로 설명된 VolumeSnapshotClass 오브젝트로 파일을 생성합니다.

   volumesnapshotclass.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshotClass
   metadata:
     name: csi-hostpath-snap
   driver: hostpath.csi.k8s.io 1
   deletionPolicy: Delete

   1

   이 VolumeSnapshotClass 오브젝트의 스냅샷을 생성하는 데 사용되는 CSI 드라이버의 이름입니다. 이름은 스냅샷을 수행 중인 PVC를 담당하는 스토리지 클래스의 Provisioner 필드와 동일해야 합니다.

   참고

   영구 스토리지를 구성하는 데 사용한 드라이버에 따라 추가 매개변수가 필요할 수 있습니다. 기존 VolumeSnapshotClass 오브젝트를 사용할 수도 있습니다.

2. 다음 명령을 입력하여 이전 단계에서 저장한 오브젝트를 생성합니다.

   $ oc create -f volumesnapshotclass.yaml

3. VolumeSnapshot 오브젝트를 생성합니다.

   volumesnapshot-dynamic.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
     name: mysnap
   spec:
     volumeSnapshotClassName: csi-hostpath-snap 1
     source:
       persistentVolumeClaimName: myclaim 2

   1

   볼륨 스냅샷의 특정 클래스에 대한 요청입니다. volumeSnapshotClassName 설정이 없으며 기본 볼륨 스냅샷 클래스가 있는 경우 기본 볼륨 스냅샷 클래스 이름을 사용하여 스냅샷이 생성됩니다. 그러나 필드가 없으며 기본 볼륨 스냅샷 클래스가 없는 경우에는 스냅샷이 생성되지 않습니다.

   2

   영구 볼륨에 바인딩된 PersistentVolumeClaim 오브젝트의 이름입니다. 이 명령은 스냅샷을 생성할 대상을 정의합니다. 스냅샷을 동적으로 프로비저닝하는 데 필요합니다.

4. 다음 명령을 입력하여 이전 단계에서 저장한 오브젝트를 생성합니다.

   $ oc create -f volumesnapshot-dynamic.yaml

1. 위에서 설명한 볼륨 스냅샷 클래스를 정의하는 것 외에도 volumeSnapshotContentName 매개변수 값을 스냅샷의 소스로 제공해야 합니다.

   volumesnapshot-manual.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
     name: snapshot-demo
   spec:
     source:
       volumeSnapshotContentName: mycontent 1

   1

   사전 프로비저닝된 스냅샷에는 volumeSnapshotContentName 매개변수가 필요합니다.

2. 다음 명령을 입력하여 이전 단계에서 저장한 오브젝트를 생성합니다.

   $ oc create -f volumesnapshot-manual.yaml

1. 생성된 볼륨 스냅샷에 대한 세부 정보를 표시하려면 다음 명령을 입력합니다.

   $ oc describe volumesnapshot mysnap

   다음 예시는 mysnap 볼륨 스냅샷에 대한 세부 정보를 표시합니다.

   volumesnapshot.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
     name: mysnap
   spec:
     source:
       persistentVolumeClaimName: myclaim
     volumeSnapshotClassName: csi-hostpath-snap
   status:
     boundVolumeSnapshotContentName: snapcontent-1af4989e-a365-4286-96f8-d5dcd65d78d6 1
     creationTime: "2020-01-29T12:24:30Z" 2
     readyToUse: true 3
     restoreSize: 500Mi

   1

   컨트롤러가 생성한 실제 스토리지 콘텐츠의 포인터입니다.

   2

   스냅샷이 생성된 시간입니다. 스냅샷에는 이 표시된 시점에서 사용 가능한 볼륨 내용이 포함되어 있습니다.

   3

   값을 true로 설정하면 스냅샷을 사용하여 새 PVC로 복원할 수 있습니다.
   값을 false로 설정하면 스냅샷이 생성됩니다. 하지만 스토리지 백엔드는 스냅샷을 사용할 수 있도록 추가 작업을 수행하여 새 볼륨으로 복원해야 합니다. 예를 들어, Amazon Elastic Block Store 데이터를 다른 저렴한 위치로 이동할 수 있으며, 이 작업에는 몇 분이 걸릴 수 있습니다.

2. 볼륨 스냅샷이 생성되었는지 확인하려면 다음 명령을 입력합니다.

   $ oc get volumesnapshotcontent

   실제 컨텐츠에 대한 포인터가 표시됩니다. boundVolumeSnapshotContentName 필드가 입력된 경우 VolumeSnapshotContent 오브젝트가 존재하고 스냅샷이 생성된 것입니다.

3. 스냅샷이 준비되었는지 확인하려면 VolumeSnapshot 오브젝트에 readyToUse: true가 있는지 확인합니다.

절차

1. 다음 예와 같이 VolumeSnapshotClass 오브젝트에 필요한 삭제 정책을 지정합니다.

   volumesnapshotclass.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshotClass
   metadata:
     name: csi-hostpath-snap
   driver: hostpath.csi.k8s.io
   deletionPolicy: Delete 1

   1

   볼륨 스냅샷을 삭제할 때 Delete 값이 설정되면 VolumeSnapshotContent 오브젝트와 함께 기본 스냅샷이 삭제됩니다. Retain 값이 설정된 경우 기본 스냅샷 및 VolumeSnapshotContent 오브젝트다 모두 유지됩니다.
   Retain 값이 설정되고 해당 VolumeSnapshotContent 오브젝트를 삭제하지 않고 VolumeSnapshot 오브젝트가 삭제되면 해당 콘텐츠는 그대로 유지됩니다. 스냅샷 자체는 스토리지 백엔드에서도 유지됩니다.

2. 다음 명령을 입력하여 볼륨 스냅샷을 삭제합니다.

   $ oc delete volumesnapshot <volumesnapshot_name>

   출력 예

   volumesnapshot.snapshot.storage.k8s.io "mysnapshot" deleted

3. 삭제 정책이 Retain으로 설정된 경우 다음 명령을 입력하여 볼륨 스냅샷 콘텐츠를 삭제합니다.

   $ oc delete volumesnapshotcontent <volumesnapshotcontent_name>

4. 선택 사항: VolumeSnapshot 오브젝트가 성공적으로 삭제되지 않으면 삭제 작업이 계속될 수 있도록 다음 명령을 입력하여 남은 리소스의 종료자를 제거합니다.

   중요

   VolumeSnapshot 오브젝트에 대한 영구 볼륨 클레임 또는 볼륨 스냅샷 콘텐츠에서 기존 참조가 없음을 확신할 수 있는 경우에만 종료자를 제거하십시오. --force 옵션을 사용하면 모든 종료자가 제거될 때까지 삭제 작업에서 스냅샷 오브젝트를 삭제하지 않습니다.

   $ oc patch -n $PROJECT volumesnapshot/$NAME --type=merge -p '{"metadata": {"finalizers":null}}'

   출력 예

   volumesnapshotclass.snapshot.storage.k8s.io "csi-ocs-rbd-snapclass" deleted

   종료자가 제거되고 볼륨 스냅샷이 삭제됩니다.

프로세스

1. 다음과 같이 PVC에서 VolumeSnapshot 데이터 소스를 지정합니다.

   pvc-restore.yaml

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: myclaim-restore
   spec:
     storageClassName: csi-hostpath-sc
     dataSource:
       name: mysnap 1
       kind: VolumeSnapshot 2
       apiGroup: snapshot.storage.k8s.io 3
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 1Gi

   1

   소스로 사용할 스냅샷을 나타내는 VolumeSnapshot 오브젝트의 이름입니다.

   2

   VolumeSnapshot 값으로 설정해야 합니다.

   3

   snapshot.storage.k8s.io 값으로 설정해야 합니다.

2. 다음 명령을 입력하여 PVC를 생성합니다.

   $ oc create -f pvc-restore.yaml

3. 다음 명령을 입력하여 복원된 PVC가 생성되었는지 확인합니다.

   $ oc get pvc

   myclaim-restore와 같은 새 PVC가 표시됩니다.

절차

1. 다음 명령을 실행하여 현재 구성 맵을 확인합니다.

   $ oc -n openshift-cluster-csi-drivers get cm/vsphere-csi-config -o yaml

   출력 예

   apiVersion: v1
   data:
     cloud.conf: |+
       # Labels with topology values are added dynamically via operator
       [Global]
       cluster-id = vsphere-01-cwv8p
   
       [VirtualCenter "vcenter.openshift.com"]
       insecure-flag           = true
       datacenters             = DEVQEdatacenter
       migration-datastore-url = ds:///vmfs/volumes/vsan:527320283a8c3163-2faa6dc5949a3a28/
   
   kind: ConfigMap
   metadata:
     creationTimestamp: "2024-03-06T09:46:40Z"
     name: vsphere-csi-config
     namespace: openshift-cluster-csi-drivers
     resourceVersion: "126687"

   이 예에서는 글로벌 최대 스냅샷 수가 구성되지 않았으므로 기본값 3이 적용됩니다.

2. 다음 명령을 실행하여 스냅샷 제한을 변경합니다.

   • 글로벌 스냅샷 제한을 설정합니다.

     $ oc patch clustercsidriver/csi.vsphere.vmware.com --type=merge -p '{"spec":{"driverConfig":{"vSphere":{"globalMaxSnapshotsPerBlockVolume": 10}}}}'
     clustercsidriver.operator.openshift.io/csi.vsphere.vmware.com patched

     이 예에서 글로벌 제한이 10(globalMaxSnapshotsPerBlockVolume 으로 설정)으로 변경됩니다.

   • 가상 볼륨 스냅샷 제한을 설정합니다.

     이 매개변수는 가상 볼륨 데이터 저장소에만 제한을 설정합니다. 가상 볼륨 최대 스냅샷 제한은 전역 제약 조건을 재정의하지만 설정되지 않은 경우 기본값은 글로벌 제한입니다.

     $ oc patch clustercsidriver/csi.vsphere.vmware.com --type=merge -p '{"spec":{"driverConfig":{"vSphere":{"granularMaxSnapshotsPerBlockVolumeInVVOL": 5}}}}'
     clustercsidriver.operator.openshift.io/csi.vsphere.vmware.com patched

     이 예에서는 가상 볼륨 제한이 5로 변경되고 있습니다(granularMaxSnapshotsPerBlockVolumeInVVOL 을 5)로 설정합니다.

   • vSAN 스냅샷 제한을 설정합니다.

     이 매개변수는 vSAN 데이터 저장소에만 제한을 설정합니다. 설정된 경우 vSAN 최대 스냅샷 제한이 전역 제약 조건을 덮어씁니다. 그러나 설정되지 않은 경우 기본값은 글로벌 제한입니다. vSAN ESA 설정에서 최대 32 값을 설정할 수 있습니다.

     $ oc patch clustercsidriver/csi.vsphere.vmware.com --type=merge -p '{"spec":{"driverConfig":{"vSphere":{"granularMaxSnapshotsPerBlockVolumeInVSAN": 7}}}}'
     clustercsidriver.operator.openshift.io/csi.vsphere.vmware.com patched

     이 예에서 vSAN 제한이 7로 변경되었습니다 (granularMaxSnapshotsPerBlockVolumeInVSAN 을 7로 설정).