Skip to main content
이 제품의 최신 릴리즈를 사용할 수 있습니다.
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

볼륨 가져오기

기여자
PDF

을 사용하여 기존 스토리지 볼륨을 Kubernetes PV로 가져올 수 tridentctl import 있습니다.

개요 및 고려 사항

다음과 같은 작업을 위해 Astra Trident로 볼륨을 가져올 수 있습니다.

  • 응용 프로그램을 Containerize 하고 기존 데이터 집합을 다시 사용합니다

  • 수명이 짧은 애플리케이션에 사용할 데이터 세트의 클론을 사용합니다

  • 오류가 발생한 Kubernetes 클러스터를 재구성합니다

  • 재해 복구 중에 애플리케이션 데이터 마이그레이션

고려 사항

볼륨을 가져오기 전에 다음 고려 사항을 검토하십시오.

  • Astra Trident는 RW(읽기-쓰기) 유형의 ONTAP 볼륨만 가져올 수 있습니다. DP(데이터 보호) 유형 볼륨은 SnapMirror 대상 볼륨입니다. Astra Trident로 볼륨을 가져오기 전에 미러 관계를 끊어야 합니다.

  • 활성 연결이 없는 볼륨을 가져오는 것이 좋습니다. 활성 볼륨을 가져오려면 볼륨을 클론한 다음 가져오기를 수행합니다.

    경고 Kubernetes가 이전 연결을 인식하지 못하고 활성 볼륨을 POD에 쉽게 연결할 수 있기 때문에 블록 볼륨에서 특히 중요합니다. 이로 인해 데이터가 손상될 수 있습니다.

  • PVC에서 지정해야 하지만 StorageClass Astra Trident는 가져오는 동안 이 매개 변수를 사용하지 않습니다. 스토리지 클래스는 볼륨 생성 중에 스토리지 특성에 따라 사용 가능한 풀에서 선택하는 데 사용됩니다. 볼륨이 이미 있으므로 가져오는 동안 풀을 선택할 필요가 없습니다. 따라서 볼륨이 PVC에 지정된 스토리지 클래스와 일치하지 않는 백엔드 또는 풀에 있더라도 가져오기에 실패합니다.

  • 기존 체적 크기는 PVC에서 결정되고 설정됩니다. 스토리지 드라이버에서 볼륨을 가져온 후 PV는 PVC에 대한 ClaimRef를 사용하여 생성됩니다.

    • 재확보 정책은 처음에 PV에서 로 retain 설정됩니다. Kubernetes에서 PVC 및 PV를 성공적으로 바인딩하면 스토리지 클래스의 부가세 반환 청구액 정책에 맞게 부가세 반환 청구액 정책이 업데이트됩니다.

    • 스토리지 클래스의 재확보 정책이 이면 delete PV를 삭제할 때 스토리지 볼륨이 삭제됩니다.

  • 기본적으로 Astra Trident는 PVC를 관리하고 백엔드에서 FlexVol 및 LUN의 이름을 바꿉니다. 플래그를 전달하여 관리되지 않는 볼륨을 가져올 수 --no-manage 있습니다. 을 사용하는 --no-manage 경우 Astra Trident는 객체 수명 주기 동안 PVC 또는 PV에 대한 추가 작업을 수행하지 않습니다. PV가 삭제되어도 스토리지 볼륨은 삭제되지 않으며 볼륨 클론 및 볼륨 크기 조정과 같은 다른 작업도 무시됩니다.

    팁 이 옵션은 컨테이너화된 워크로드에 Kubernetes를 사용하고, 그렇지 않고 Kubernetes 외부 스토리지 볼륨의 라이프사이클을 관리하려는 경우에 유용합니다.

  • PVC 및 PV에 주석이 추가되어 용적을 가져온 후 PVC와 PV가 관리되었는지 여부를 나타내는 두 가지 목적으로 사용됩니다. 이 주석은 수정하거나 제거할 수 없습니다.

볼륨을 가져옵니다

를 사용하여 볼륨을 가져올 수 tridentctl import 있습니다.

단계

  1. PVC를 생성하는 데 사용할 PVC(Persistent Volume Claim) 파일(예:)을 만듭니다 pvc.yaml. PVC 파일에는 namespace , , accessModes 및 storageClassName`이 포함되어야 `name 합니다. 선택적으로 PVC 정의에 지정할 수 unixPermissions 있습니다.

    다음은 최소 사양의 예입니다.

    kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: my_claim
  namespace: my_namespace
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: my_storage_class
    경고 PV 이름 또는 볼륨 크기와 같은 추가 매개 변수는 포함하지 마십시오. 이로 인해 가져오기 명령이 실패할 수 있습니다.

  2. `tridentctl import`명령을 사용하여 볼륨이 포함된 Astra Trident 백엔드의 이름과 스토리지에서 볼륨을 고유하게 식별하는 이름(예: ONTAP FlexVol, Element Volume, Cloud Volumes Service 경로)을 지정할 수 있습니다. `-f`PVC 파일의 경로를 지정하려면 인수가 필요합니다.

    tridentctl import volume <backendName> <volumeName> -f <path-to-pvc-file>

예

지원되는 드라이버에 대한 다음 볼륨 가져오기 예를 검토하십시오.

ONTAP NAS 및 ONTAP NAS FlexGroup를 지원합니다

Astra Trident은 및 ontap-nas-flexgroup 드라이버를 사용한 볼륨 가져오기를 ontap-nas 지원합니다.

참고

  • `ontap-nas-economy`드라이버는 qtree를 가져오고 관리할 수 없습니다.

  • ontap-nas`및 `ontap-nas-flexgroup 드라이버는 중복 볼륨 이름을 허용하지 않습니다.

드라이버로 생성된 각 볼륨은 ontap-nas ONTAP 클러스터의 FlexVol입니다. 드라이버를 사용하여 FlexVols 가져오기도 ontap-nas 동일하게 작동합니다. ONTAP 클러스터에 이미 있는 FlexVol를 PVC로 가져올 수 ontap-nas 있습니다. 마찬가지로 FlexGroup 볼륨을 PVC로 가져올 수 ontap-nas-flexgroup 있습니다.

ONTAP NAS의 예

다음은 관리되는 볼륨 및 관리되지 않는 볼륨 가져오기의 예입니다.

관리 볼륨

다음 예에서는 라는 이름의 백엔드에 ontap_nas 있는 볼륨을 가져옵니다 managed_volume.

tridentctl import volume ontap_nas managed_volume -f <path-to-pvc-file>

+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
|                   NAME                   |  SIZE   | STORAGE CLASS | PROTOCOL |             BACKEND UUID             | STATE  | MANAGED |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
| pvc-bf5ad463-afbb-11e9-8d9f-5254004dfdb7 | 1.0 GiB | standard      | file     | c5a6f6a4-b052-423b-80d4-8fb491a14a22 | online | true    |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
관리되지 않는 볼륨

인수를 사용할 때 --no-manage Astra Trident에서는 볼륨 이름을 바꾸지 않습니다.

다음 예는 unmanaged_volume ontap_nas 백엔드에서 가져옵니다.

tridentctl import volume nas_blog unmanaged_volume -f <path-to-pvc-file> --no-manage

+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
|                   NAME                   |  SIZE   | STORAGE CLASS | PROTOCOL |             BACKEND UUID             | STATE  | MANAGED |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
| pvc-df07d542-afbc-11e9-8d9f-5254004dfdb7 | 1.0 GiB | standard      | file     | c5a6f6a4-b052-423b-80d4-8fb491a14a22 | online | false   |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+

ONTAP SAN

Astra Trident는 드라이버를 사용한 볼륨 가져오기를 ontap-san 지원합니다. 드라이버를 사용하면 볼륨 가져오기가 지원되지 ontap-san-economy 않습니다.

Astra Trident는 단일 LUN이 포함된 ONTAP SAN FlexVol을 가져올 수 있습니다. 이는 ontap-san 각 PVC 및 FlexVol 내의 LUN에 대한 FlexVol를 생성하는 드라이버와 일치합니다. Astra Trident는 FlexVol를 불러와 PVC 정의와 연결합니다.

ONTAP SAN 예

다음은 관리되는 볼륨 및 관리되지 않는 볼륨 가져오기의 예입니다.

관리 볼륨

관리되는 볼륨의 경우 Astra Trident의 경우 FlexVol의 이름을 형식으로, FlexVol 내의 LUN의 lun0 이름을 pvc-<uuid> 로 바꿉니다.

다음 예에서는 ontap-san-managed 백엔드에 있는 FlexVol를 ontap_san_default 가져옵니다.

tridentctl import volume ontapsan_san_default ontap-san-managed -f pvc-basic-import.yaml -n trident -d

+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+
|                   NAME                   |  SIZE  | STORAGE CLASS | PROTOCOL |             BACKEND UUID             | STATE  | MANAGED |
+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+
| pvc-d6ee4f54-4e40-4454-92fd-d00fc228d74a | 20 MiB | basic         | block    | cd394786-ddd5-4470-adc3-10c5ce4ca757 | online | true    |
+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+
관리되지 않는 볼륨

다음 예는 unmanaged_example_volume ontap_san 백엔드에서 가져옵니다.

tridentctl import volume -n trident san_blog unmanaged_example_volume -f pvc-import.yaml --no-manage
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
|                   NAME                   |  SIZE   | STORAGE CLASS | PROTOCOL |             BACKEND UUID             | STATE  | MANAGED |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
| pvc-1fc999c9-ce8c-459c-82e4-ed4380a4b228 | 1.0 GiB | san-blog      | block    | e3275890-7d80-4af6-90cc-c7a0759f555a | online | false   |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+

다음 예에서와 같이 Kubernetes 노드 IQN과 IQN을 공유하는 igroup에 LUN이 매핑되어 있으면 오류가 LUN already mapped to initiator(s) in this group 표시됩니다. 볼륨을 가져오려면 이니시에이터를 제거하거나 LUN 매핑을 해제해야 합니다.

iqn 및 클러스터 iqn에 매핑된 LUN 이미지

요소

Astra Trident는 드라이버를 사용하여 NetApp Element 소프트웨어 및 NetApp HCI 볼륨 가져오기를 solidfire-san 지원합니다.

참고 Element 드라이버는 중복 볼륨 이름을 지원합니다. 그러나 중복 볼륨 이름이 있는 경우 Astra Trident에서 오류를 반환합니다. 이 문제를 해결하려면 볼륨을 클론하고 고유한 볼륨 이름을 제공한 다음 복제된 볼륨을 가져옵니다.
요소 예제

다음 예에서는 element-managed 백엔드에서 볼륨을 element_default 가져옵니다.

tridentctl import volume element_default element-managed -f pvc-basic-import.yaml -n trident -d

+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+
|                   NAME                   |  SIZE  | STORAGE CLASS | PROTOCOL |             BACKEND UUID             | STATE  | MANAGED |
+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+
| pvc-970ce1ca-2096-4ecd-8545-ac7edc24a8fe | 10 GiB | basic-element | block    | d3ba047a-ea0b-43f9-9c42-e38e58301c49 | online | true    |
+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+

Google 클라우드 플랫폼

Astra Trident는 드라이버를 사용한 볼륨 가져오기를 gcp-cvs 지원합니다.

참고 Google Cloud Platform에서 NetApp Cloud Volumes Service가 지원하는 볼륨을 가져오려면 해당 볼륨 경로를 기준으로 볼륨을 식별합니다. 볼륨 경로는 다음에 나오는 볼륨의 내보내기 경로의 :/ 일부입니다. 예를 들어, 엑스포트 경로가 인 경우 10.0.0.1:/adroit-jolly-swift 볼륨 경로는 입니다 adroit-jolly-swift.
Google Cloud Platform의 예

다음 예에서는 gcp-cvs 의 볼륨 경로를 사용하여 adroit-jolly-swift 백엔드에서 볼륨을 gcpcvs_YEppr 가져옵니다.

tridentctl import volume gcpcvs_YEppr adroit-jolly-swift -f <path-to-pvc-file> -n trident

+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+
|                   NAME                   |  SIZE  | STORAGE CLASS | PROTOCOL |             BACKEND UUID             | STATE  | MANAGED |
+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+
| pvc-a46ccab7-44aa-4433-94b1-e47fc8c0fa55 | 93 GiB | gcp-storage   | file     | e1a6e65b-299e-4568-ad05-4f0a105c888f | online | true    |
+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+

Azure NetApp Files

Astra Trident는 드라이버를 사용한 볼륨 가져오기를 azure-netapp-files 지원합니다.

참고 Azure NetApp Files 볼륨을 가져오려면 해당 볼륨 경로를 기준으로 볼륨을 식별합니다. 볼륨 경로는 다음에 나오는 볼륨의 내보내기 경로의 :/ 일부입니다. 예를 들어, 마운트 경로가 인 경우 10.0.0.2:/importvol1 볼륨 경로는 입니다 importvol1.
Azure NetApp Files의 예

다음 예에서는 azure-netapp-files 볼륨 경로가 있는 importvol1 백엔드에서 볼륨을 azurenetappfiles_40517 가져옵니다.

tridentctl import volume azurenetappfiles_40517 importvol1 -f <path-to-pvc-file> -n trident

+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
|                   NAME                   |  SIZE   | STORAGE CLASS | PROTOCOL |             BACKEND UUID             | STATE  | MANAGED |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
| pvc-0ee95d60-fd5c-448d-b505-b72901b3a4ab | 100 GiB | anf-storage   | file     | 1c01274f-d94b-44a3-98a3-04c953c9a51e | online | true    |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+