Skip to main content
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Configurar a configuração automática de backend para AWS FSx para NetApp ONTAP

Colaboradores joan-ing
PDFs

Trident oferece suporte à configuração automática de backend para AWS FSx for NetApp ONTAP (FSxN).

Ao criar um StorageClass que inclua os parâmetros FSxN necessários, Trident cria automaticamente o backend correspondente e um VolumeSnapshotClass. Trident cria o VolumeSnapshotClass apenas uma vez para uma determinada configuração de driver e o reutiliza para StorageClasses subsequentes.

Entenda como funciona a configuração automática do backend

Trident deriva a configuração do backend da definição de StorageClass.

Aplique o StorageClass para acionar a configuração automática do backend. Trident executa as seguintes ações:

  • Valida os parâmetros necessários

  • Cria o backend automaticamente

  • Cria um VolumeSnapshotClass (apenas uma vez)

  • Anota o StorageClass com o status da configuração

Após a configuração ser concluída com sucesso, você pode criar PersistentVolumeClaims que referenciam este StorageClass.

Especifique os parâmetros necessários de StorageClass

Defina os parâmetros necessários na seção parameters do StorageClass para acionar a criação automática do backend.

Parâmetro Obrigatório Tipo Descrição

fsxFilesystemID

Sim

cadeia de carateres

ID do sistema de arquivos FSx for NetApp ONTAP.

storageDriverName

Sim

cadeia de carateres

Driver de storage Trident. Por exemplo: ontap-nas ou ontap-san.

credentialsName

Sim

cadeia de carateres

Nome ou ARN do segredo do AWS Secrets Manager que contém credenciais.

Especifique parâmetros opcionais

Você pode passar parâmetros opcionais para o backend através do StorageClass.

Todos os parâmetros de backend suportados para FSx para NetApp ONTAP backends também podem ser passados diretamente através da seção parameters do StorageClass.

Parâmetro Obrigatório Tipo Descrição

Parâmetros de backend

Opcional

cadeia de carateres

Todos os parâmetros de backend suportados pelo FSx para NetApp ONTAP podem ser passados diretamente pela seção StorageClass parameters. Cada parâmetro deve ser definido como uma string.

Importante:

  • Todos os parâmetros devem ser definidos como strings.

  • Todos os parâmetros devem aparecer na seção parameters do StorageClass.

Para obter uma lista completa dos parâmetros de backend suportados, consulte:

Configuração do backend FSx para NetApp ONTAP.

Crie um StorageClass

Crie um StorageClass que inclua os parâmetros FSxN necessários.

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

Aplique o StorageClass para acionar a criação automática do backend.

Trident cria automaticamente os recursos de backend necessários internamente.

Verifique o status da configuração do backend

Verifique o status da configuração do backend usando as anotações do StorageClass.

Execute o seguinte comando:

kubectl get storageclass ontap-fsx-demo -o yaml

Exemplo de saída:

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

Principais anotações:

Anotação Descrição

trident.netapp.io/configuratorStatus

Resultado da configuração (Success ou Failure).

trident.netapp.io/configuratorMessage

Status detalhado da configuração ou mensagem de erro.

trident.netapp.io/configuratorName

Nome do recurso do configurador interno.

trident.netapp.io/managed

Indica que o StorageClass é gerenciado pela Trident.

trident.netapp.io/additionalStoragePools

Pools de storage criados para este backend.

Se a configuração for bem-sucedida (configuratorStatus: Success, o StorageClass está totalmente operacional.

Agora você pode:

  • Crie PersistentVolumeClaims usando esta StorageClass

  • Monte os volumes resultantes nas cargas de trabalho do aplicativo

Adicionar sistemas de arquivos FSxN adicionais

Se for necessária capacidade de storage adicional enquanto continua usando o mesmo StorageClass, anexe sistemas de arquivos FSx adicionais para NetApp ONTAP.

Edite o StorageClass:

kubectl edit storageclass <storageclass-name>

Adicione ou atualize a anotação com IDs de filesystem adicionais:

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

Exemplo StorageClass com um sistema de arquivos 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 operação adiciona capacidade de storage adicional enquanto continua a usar a StorageClass existente.

Considerações operacionais e limitações

A exclusão de um StorageClass normalmente exclui o backend Trident associado.

Isso pode interromper a conectividade de storage e quebrar cargas de trabalho em execução.

Verifique o impacto potencial antes de excluir qualquer StorageClass gerenciado.

A configuração automática de backend é suportada apenas para AWS FSx para NetApp ONTAP.