Skip to main content
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Volumi di importazione

Collaboratori netapp-aruldeepa
PDF

È possibile importare volumi di archiviazione esistenti come PV Kubernetes utilizzando tridentctl import o creando un Persistent Volume Claim (PVC) con annotazioni di importazione Trident.

Panoramica e considerazioni

È possibile importare un volume in Trident per:

  • Containerizzare un'applicazione e riutilizzare il suo set di dati esistente

  • Utilizzare un clone di un set di dati per un'applicazione effimera

  • Ricostruisci un cluster Kubernetes non riuscito

  • Migrare i dati dell'applicazione durante il ripristino di emergenza

Considerazioni

Prima di importare un volume, esaminare le seguenti considerazioni.

  • Trident può importare solo volumi ONTAP di tipo RW (lettura-scrittura). I volumi di tipo DP (protezione dati) sono volumi di destinazione SnapMirror . Prima di importare il volume in Trident, è necessario interrompere la relazione mirror.

  • Suggeriamo di importare volumi senza connessioni attive. Per importare un volume utilizzato attivamente, clonare il volume e quindi eseguire l'importazione.

    Attenzione Ciò è particolarmente importante per i volumi a blocchi, poiché Kubernetes non sarebbe a conoscenza della connessione precedente e potrebbe facilmente collegare un volume attivo a un pod. Ciò può causare il danneggiamento dei dati.

  • Anche se StorageClass deve essere specificato su un PVC, Trident non utilizza questo parametro durante l'importazione. Le classi di archiviazione vengono utilizzate durante la creazione del volume per selezionare tra i pool disponibili in base alle caratteristiche di archiviazione. Poiché il volume esiste già, non è richiesta alcuna selezione del pool durante l'importazione. Pertanto, l'importazione non fallirà anche se il volume esiste su un backend o pool che non corrisponde alla classe di archiviazione specificata nel PVC.

  • La dimensione del volume esistente viene determinata e impostata nel PVC. Dopo che il volume è stato importato dal driver di archiviazione, il PV viene creato con un ClaimRef al PVC.

    • La politica di recupero è inizialmente impostata su retain nel PV. Dopo che Kubernetes ha associato correttamente PVC e PV, la policy di recupero viene aggiornata per corrispondere alla policy di recupero della classe di archiviazione.

    • Se la politica di recupero della classe di archiviazione è delete , il volume di archiviazione verrà eliminato quando il PV verrà eliminato.

  • Per impostazione predefinita, Trident gestisce il PVC e rinomina il FlexVol volume e il LUN sul backend. Puoi passare il --no-manage flag per importare un volume non gestito. Se usi --no-manage , Trident non esegue alcuna operazione aggiuntiva sul PVC o sul PV per l'intero ciclo di vita degli oggetti. Il volume di archiviazione non viene eliminato quando si elimina il PV e anche altre operazioni come la clonazione del volume e il ridimensionamento del volume vengono ignorate.

    Suggerimento Questa opzione è utile se si desidera utilizzare Kubernetes per carichi di lavoro containerizzati ma si desidera gestire il ciclo di vita del volume di archiviazione al di fuori di Kubernetes.

  • Viene aggiunta un'annotazione al PVC e al PV che ha il duplice scopo di indicare che il volume è stato importato e se il PVC e il PV sono gestiti. Questa annotazione non deve essere modificata o rimossa.

Importa un volume

È possibile importare un volume utilizzando tridentctl import oppure creando un PVC con annotazioni di importazione Trident.

Nota Se si utilizzano annotazioni PVC, non è necessario scaricare o utilizzare tridentctl per importare il volume.
Utilizzo di tridentctl
Passi

  1. Crea un file PVC (ad esempio, pvc.yaml) che verrà utilizzato per creare il PVC. Il file PVC dovrebbe includere name, namespace, accessModes e storageClassName. Facoltativamente, puoi specificare unixPermissions nella definizione del PVC.

    Di seguito è riportato un esempio di specifica minima:

    kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: my_claim
  namespace: my_namespace
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: my_storage_class
    Nota Includere solo i parametri obbligatori. Parametri aggiuntivi come il nome del PV o la dimensione del volume possono causare il fallimento del comando di importazione.

  2. Utilizzare il tridentctl import comando per specificare il nome del backend Trident contenente il volume e il nome che identifica in modo univoco il volume nello storage (ad esempio: ONTAP FlexVol, Element Volume, percorso Cloud Volumes Service ). IL -f L'argomento è necessario per specificare il percorso del file PVC.

    tridentctl import volume <backendName> <volumeName> -f <path-to-pvc-file>
Utilizzo delle annotazioni PVC
Passi

  1. Creare un file PVC YAML (ad esempio, pvc.yaml) con le annotazioni di importazione Trident richieste. Il file PVC deve includere:

    • name and namespace nei metadati

    • accessModes, resources.requests.storage, e storageClassName nelle specifiche

    • Annotazioni:

      • trident.netapp.io/importOriginalName: Nome volume sul backend

      • trident.netapp.io/importBackendUUID: UUID del backend in cui esiste il volume

      • trident.netapp.io/notManaged (Facoltativo): Impostare su "true" per i volumi non gestiti. L'impostazione predefinita è "false".

        Di seguito è riportato un esempio di specifica per l'importazione di un volume gestito:

    kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: <pvc-name>
  namespace: <namespace>
  annotations:
    trident.netapp.io/importOriginalName: "<volume-name>"
    trident.netapp.io/importBackendUUID: "<backend-uuid>"
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: <size>
  storageClassName: <storage-class-name>

  2. Applica il file PVC YAML al tuo cluster Kubernetes:

    kubectl apply -f <pvc-file>.yaml

    Trident importerà automaticamente il volume e lo assocerà al PVC.

Esempi

Esaminare i seguenti esempi di importazione di volumi per i driver supportati.

ONTAP NAS e ONTAP NAS FlexGroup

Trident supporta l'importazione di volumi utilizzando ontap-nas E ontap-nas-flexgroup conducenti.

Nota

  • Trident non supporta l'importazione di volumi utilizzando ontap-nas-economy autista.

  • IL ontap-nas E ontap-nas-flexgroup i driver non consentono nomi di volume duplicati.

Ogni volume creato con il ontap-nas il driver è un FlexVol volume sul cluster ONTAP . Importazione di volumi FlexVol con ontap-nas il driver funziona allo stesso modo. Un volume FlexVol già esistente su un cluster ONTAP può essere importato come ontap-nas PVC. Allo stesso modo, i volumi FlexGroup possono essere importati come ontap-nas-flexgroup PVC.

Esempi di ONTAP NAS utilizzando tridentctl

Di seguito è riportato un esempio di importazione di un volume gestito e di un volume non gestito.

Volume gestito

L'esempio seguente importa un volume denominato managed_volume su un backend denominato ontap_nas :

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    |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
Volume non gestito

Quando si utilizza il --no-manage argomento, Trident non rinomina il volume.

Il seguente esempio importa unmanaged_volume sul ontap_nas backend:

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   |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+
Esempi ONTAP NAS che utilizzano annotazioni PVC

I seguenti esempi mostrano come importare volumi gestiti e non gestiti utilizzando annotazioni PVC.

Volume gestito

Il seguente esempio importa un volume da 1GiB ontap-nas denominato ontap_volume1 dal backend 81abcb27-ea63-49bb-b606-0a5315ac5f21 con modalità di accesso RWO impostata tramite annotazioni PVC:

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: <managed-imported-volume>
  namespace: <namespace>
  annotations:
    trident.netapp.io/importOriginalName: "ontap_volume1"
    trident.netapp.io/importBackendUUID: "81abcb27-ea63-49bb-b606-0a5315ac5f21"
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
  storageClassName: <storage-class-name>
Volume non gestito

Il seguente esempio importa 1Gi ontap-nas volume denominato ontap-volume2 dal backend 34abcb27-ea63-49bb-b606-0a5315ac5f34 con modalità di accesso RWO impostata tramite annotazioni PVC:

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: <umanaged-imported-volume>
  namespace: <namespace>
  annotations:
    trident.netapp.io/importOriginalName: "ontap-volume2"
    trident.netapp.io/importBackendUUID: "34abcb27-ea63-49bb-b606-0a5315ac5f34"
    trident.netapp.io/notManaged: "true"
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
  storageClassName: <storage-class-name>

ONTAP SAN

Trident supporta l'importazione di volumi utilizzando ontap-san (iSCSI, NVMe/TCP e FC) e ontap-san-economy conducenti.

Trident può importare volumi ONTAP SAN FlexVol che contengono un singolo LUN. Ciò è coerente con il ontap-san driver, che crea un FlexVol volume per ogni PVC e un LUN all'interno del FlexVol volume. Trident importa il FlexVol volume e lo associa alla definizione PVC. Trident può importare ontap-san-economy volumi che contengono più LUN.

Esempi ONTAP SAN

I seguenti esempi mostrano come importare volumi gestiti e non gestiti:

Volume gestito

Per i volumi gestiti, Trident rinomina il FlexVol volume in pvc-<uuid> formato e LUN all'interno del FlexVol volume per lun0 .

L'esempio seguente importa il ontap-san-managed FlexVol volume presente sul ontap_san_default backend:

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    |
+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+
Volume non gestito

Il seguente esempio importa unmanaged_example_volume sul ontap_san backend:

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   |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+

Se hai LUNS mappati su igroup che condividono un IQN con un IQN del nodo Kubernetes, come mostrato nell'esempio seguente, riceverai l'errore: LUN already mapped to initiator(s) in this group . Per importare il volume sarà necessario rimuovere l'iniziatore o annullare la mappatura del LUN.

Immagine di LUNS mappata su iqn e cluster iqn.

Elemento

Trident supporta il software NetApp Element e l'importazione di volumi NetApp HCI utilizzando solidfire-san autista.

Nota Il driver Element supporta nomi di volume duplicati. Tuttavia, Trident restituisce un errore se sono presenti nomi di volume duplicati. Come soluzione alternativa, clonare il volume, fornire un nome di volume univoco e importare il volume clonato.

L'esempio seguente importa un element-managed volume sul backend 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    |
+------------------------------------------+--------+---------------+----------+--------------------------------------+--------+---------+

Piattaforma Google Cloud

Trident supporta l'importazione di volumi utilizzando gcp-cvs autista.

Nota Per importare un volume supportato dal servizio NetApp Cloud Volumes Service in Google Cloud Platform, identifica il volume tramite il suo percorso. Il percorso del volume è la parte del percorso di esportazione del volume dopo il :/ . Ad esempio, se il percorso di esportazione è 10.0.0.1:/adroit-jolly-swift , il percorso del volume è adroit-jolly-swift .
Esempio di Google Cloud Platform

L'esempio seguente importa un gcp-cvs volume sul backend gcpcvs_YEppr con il percorso del volume di adroit-jolly-swift .

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

Trident supporta l'importazione di volumi utilizzando azure-netapp-files autista.

Nota Per importare un volume Azure NetApp Files , identifica il volume tramite il suo percorso. Il percorso del volume è la parte del percorso di esportazione del volume dopo il :/ . Ad esempio, se il percorso di montaggio è 10.0.0.2:/importvol1 , il percorso del volume è importvol1 .

L'esempio seguente importa un azure-netapp-files volume sul backend azurenetappfiles_40517 con il percorso del volume importvol1 .

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    |
+------------------------------------------+---------+---------------+----------+--------------------------------------+--------+---------+

Google Cloud NetApp Volumes

Trident supporta l'importazione di volumi utilizzando google-cloud-netapp-volumes autista.

Il seguente esempio importa un volume su backend backend-tbc-gcnv1 con il volume testvoleasiaeast1.

tridentctl import volume backend-tbc-gcnv1 "testvoleasiaeast1" -f < path-to-pvc> -n trident

+------------------------------------------+---------+----------------------+----------+--------------------------------------+--------+---------+
|                   NAME                   |  SIZE   | STORAGE CLASS        | PROTOCOL |             BACKEND UUID             | STATE  | MANAGED |
+------------------------------------------+---------+----------------------+----------+--------------------------------------+--------+---------+
| pvc-a69cda19-218c-4ca9-a941-aea05dd13dc0 |  10 GiB | gcnv-nfs-sc-identity | file     | 8c18cdf1-0770-4bc0-bcc5-c6295fe6d837 | online | true    |
+------------------------------------------+---------+----------------------+----------+--------------------------------------+--------+---------+

L'esempio seguente importa un google-cloud-netapp-volumes volume quando due volumi sono presenti nella stessa regione:

tridentctl import volume backend-tbc-gcnv1 "projects/123456789100/locations/asia-east1-a/volumes/testvoleasiaeast1" -f <path-to-pvc> -n trident

+------------------------------------------+---------+----------------------+----------+--------------------------------------+--------+---------+
|                   NAME                   |  SIZE   | STORAGE CLASS        | PROTOCOL |             BACKEND UUID             | STATE  | MANAGED |
+------------------------------------------+---------+----------------------+----------+--------------------------------------+--------+---------+
| pvc-a69cda19-218c-4ca9-a941-aea05dd13dc0 |  10 GiB | gcnv-nfs-sc-identity | file     | 8c18cdf1-0770-4bc0-bcc5-c6295fe6d837 | online | true    |
+------------------------------------------+---------+----------------------+----------+--------------------------------------+--------+---------+