Skip to main content
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Configura la configuración automática del backend para AWS FSx para NetApp ONTAP

Colaboradores joan-ing
PDF

Trident admite la configuración automática de backend para AWS FSx for NetApp ONTAP (FSxN).

Cuando creas un StorageClass que incluye los parámetros FSxN necesarios, Trident crea automáticamente el backend correspondiente y un VolumeSnapshotClass. Trident crea el VolumeSnapshotClass solo una vez para una configuración de driver determinada y lo reutiliza para los siguientes StorageClasses.

Entiende cómo funciona la configuración automática del backend

Trident obtiene la configuración del backend a partir de la definición de StorageClass.

Aplica el StorageClass para activar la configuración automática del backend. Trident realiza las siguientes acciones:

  • Valida los parámetros requeridos

  • Crea el backend automáticamente

  • Crea un VolumeSnapshotClass (solo una vez)

  • Anota la StorageClass con el estado de configuración

Después de que la configuración se complete correctamente, puedes crear PersistentVolumeClaims que hagan referencia a esta StorageClass.

Especifica los parámetros requeridos StorageClass

Define los parámetros necesarios en la parameters sección de StorageClass para activar la creación automática del backend.

Parámetro Obligatorio Tipo Descripción

fsxFilesystemID

Sí

cadena

FSx para NetApp ONTAP filesystem ID.

storageDriverName

Sí

cadena

Controlador de almacenamiento Trident. Por ejemplo: ontap-nas o ontap-san.

credentialsName

Sí

cadena

Nombre o ARN del secreto de AWS Secrets Manager que contiene credenciales.

Especifica parámetros opcionales

Puedes pasar parámetros opcionales de backend a través de StorageClass.

Todos los parámetros de backend compatibles con FSx para NetApp ONTAP también se pueden pasar directamente a través de la sección parameters de StorageClass.

Parámetro Obligatorio Tipo Descripción

Parámetros de backend

Opcional

cadena

Todos los parámetros de backend compatibles con FSx para NetApp ONTAP pueden pasarse directamente a través de la sección StorageClass parameters. Cada parámetro debe definirse como una cadena.

Importante:

  • Todos los parámetros deben definirse como cadenas.

  • Todos los parámetros deben aparecer en la parameters sección de StorageClass.

Para obtener una lista completa de los parámetros de backend compatibles, consulta:

Configuración del backend de FSx para NetApp ONTAP.

Crea un StorageClass

Crea un StorageClass que incluya los parámetros FSxN necesarios.

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: ontap-fsx-demo
  annotations:
    description: "Demo StorageClass for FSxN"
provisioner: csi.trident.netapp.io
parameters:
  fsxFilesystemID: "fs-0abc123"
  storageDriverName: "ontap-nas"
  credentialsName: "arn:aws:secretsmanager:us-west-2:123456789012:secret:trident-creds"
allowVolumeExpansion: true
reclaimPolicy: Delete
volumeBindingMode: Immediate

Aplica el StorageClass para activar la creación automática del backend.

Trident crea automáticamente los recursos backend necesarios internamente.

Verifica el estado de la configuración del backend

Verifica el estado de la configuración del backend usando las anotaciones de StorageClass.

Ejecute el siguiente comando:

kubectl get storageclass ontap-fsx-demo -o yaml

Ejemplo de salida:

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  annotations:
    trident.netapp.io/additionalStoragePools: trident-nas-sc1-fs-0752884ae35c620a0-nfs:.*
    trident.netapp.io/configuratorMessage: Completed Trident backend configuration
    trident.netapp.io/configuratorName: tconf-nas-sc1
    trident.netapp.io/configuratorStatus: Success
    trident.netapp.io/managed: "true"
parameters:
  credentialsName: arn:aws:secretsmanager:us-west-2:test-arn
  fsxFilesystemID: fs-0752884ae35c620a0
  storageDriverName: ontap-nas
provisioner: csi.trident.netapp.io
reclaimPolicy: Delete
volumeBindingMode: Immediate

Anotaciones clave:

Anotación Descripción

trident.netapp.io/configuratorStatus

Resultado de la configuración (Success o Failure).

trident.netapp.io/configuratorMessage

Estado de configuración detallado o mensaje de error.

trident.netapp.io/configuratorName

Nombre interno del configurador de recursos.

trident.netapp.io/managed

Indica que el StorageClass está gestionado por Trident.

trident.netapp.io/additionalStoragePools

Grupos de almacenamiento creados para este backend.

Si la configuración tiene éxito (configuratorStatus: Success, el StorageClass es totalmente operativo.

Ahora puedes:

  • Crea PersistentVolumeClaims usando este StorageClass

  • Monta los volúmenes resultantes en cargas de trabajo de aplicaciones

Añade sistemas de archivos FSxN adicionales

Si se requiere capacidad de almacenamiento adicional mientras se sigue utilizando el mismo StorageClass, conecta sistemas de archivos FSx adicionales para NetApp ONTAP.

Edita el StorageClass:

kubectl edit storageclass <storageclass-name>

Agrega o actualiza la anotación con IDs de sistema de archivos adicionales:

metadata:
  annotations:
    trident.netapp.io/additionalFsxNFileSystemID: '["fs-03cc1a718cddd6e248"]'

Ejemplo de StorageClass con un sistema de archivos adicional:

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: test-ontap-fsx
  annotations:
    trident.netapp.io/additionalFsxNFileSystemID: '["fs-03cc1a718cddd6e248"]'
    trident.netapp.io/additionalStoragePools: trident-test-ontap-fsx-fs-0056066a48e4b22ee91-iscsi:.*
    trident.netapp.io/configuratorMessage: Completed Trident backend configuration
    trident.netapp.io/configuratorName: tconf-test-ontap-fsx
    trident.netapp.io/configuratorStatus: Success
    trident.netapp.io/managed: "true"
parameters:
  credentialsName: arn:aws:secretsmanager:us-west-2:1866785786363:secret:trident-fsx
  fsxFilesystemID: fs-0056066a48e4b22e91
  storageDriverName: ontap-san
  svmName: testSvm
provisioner: csi.trident.netapp.io
reclaimPolicy: Delete
volumeBindingMode: Immediate

Esta operación añade capacidad de almacenamiento adicional mientras sigues usando la actual StorageClass.

Consideraciones operativas y limitaciones

Eliminar un StorageClass normalmente elimina el backend Trident asociado.

Esto puede interrumpir la conectividad de almacenamiento y romper las cargas de trabajo en ejecución.

Verifica el impacto potencial antes de eliminar cualquier StorageClass gestionado.

La configuración automática del backend solo es compatible con AWS FSx for NetApp ONTAP.