본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

AWS FSx for NetApp ONTAP에 대한 자동 백엔드 구성 구성

03/12/2026 기여자

Trident는 AWS FSx for NetApp ONTAP(FSxN)에 대한 자동 백엔드 구성을 지원합니다.

필수 FSxN 매개변수를 포함하는 StorageClass를 생성하면 Trident가 자동으로 해당 백엔드와 VolumeSnapshotClass를 생성합니다. Trident는 특정 드라이버 구성에 대해 VolumeSnapshotClass를 한 번만 생성하고 이후 StorageClasses에 대해 재사용합니다.

자동 백엔드 구성 작동 방식 이해

Trident는 StorageClass 정의에서 백엔드 구성을 가져옵니다.

StorageClass를 적용하여 백엔드 자동 구성을 트리거합니다. Trident는 다음과 같은 작업을 수행합니다.

필수 매개변수를 검증합니다
백엔드를 자동으로 생성합니다
VolumeSnapshotClass를 생성합니다(1회만)
StorageClass에 구성 상태를 주석으로 추가합니다

구성이 성공하면, 이 StorageClass를 참조하는 PersistentVolumeClaims를 생성할 수 있습니다.

필수 StorageClass 매개변수를 지정하세요

`parameters` 섹션의 StorageClass에서 필요한 매개 변수를 정의하여 백엔드 자동 생성을 트리거하십시오.

매개 변수 필수 요소입니다 유형 설명

매개 변수	필수 요소입니다	유형	설명
`fsxFilesystemID`	예	문자열	FSx for NetApp ONTAP 파일 시스템 ID.
'torageDriverName'입니다	예	문자열	Trident 스토리지 드라이버. 예: `ontap-nas` 또는 `ontap-san`.
`credentialsName`	예	문자열	자격 증명이 포함된 AWS Secrets Manager 시크릿의 이름 또는 ARN입니다.

fsxFilesystemID

예

문자열

FSx for NetApp ONTAP 파일 시스템 ID.

'torageDriverName'입니다

예

문자열

Trident 스토리지 드라이버. 예: ontap-nas 또는 ontap-san.

credentialsName

예

문자열

자격 증명이 포함된 AWS Secrets Manager 시크릿의 이름 또는 ARN입니다.

선택적 매개변수 지정

StorageClass를 통해 선택적 백엔드 매개 변수를 전달할 수 있습니다.

FSx for NetApp ONTAP 백엔드에 대해 지원되는 모든 백엔드 매개변수는 StorageClass의 parameters 섹션을 통해 직접 전달할 수도 있습니다.

매개 변수 필수 요소입니다 유형 설명

매개 변수	필수 요소입니다	유형	설명
백엔드 매개 변수	선택 사항	문자열	FSx for NetApp ONTAP에 대해 지원되는 모든 백엔드 매개변수는 StorageClass `parameters` 섹션을 통해 직접 전달할 수 있습니다. 각 매개변수는 문자열로 정의해야 합니다.

백엔드 매개 변수

선택 사항

문자열

FSx for NetApp ONTAP에 대해 지원되는 모든 백엔드 매개변수는 StorageClass parameters 섹션을 통해 직접 전달할 수 있습니다. 각 매개변수는 문자열로 정의해야 합니다.

중요:

모든 매개변수는 문자열로 정의되어야 합니다.
모든 매개변수는 StorageClass의 parameters 섹션에 나타나야 합니다.

지원되는 백엔드 매개 변수의 전체 목록은 다음을 참조하십시오.

FSx for NetApp ONTAP 백엔드 구성.

StorageClass 생성

필수 FSxN 매개변수를 포함하는 StorageClass를 생성합니다.

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

StorageClass를 적용하여 자동 백엔드 생성을 트리거합니다.

Trident는 필요한 백엔드 리소스를 자동으로 내부적으로 생성합니다.

백엔드 구성 상태를 확인합니다

StorageClass 어노테이션을 사용하여 백엔드 구성 상태를 확인합니다.

다음 명령을 실행합니다.

kubectl get storageclass ontap-fsx-demo -o yaml

출력 예:

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

주요 주석:

주석 설명

주석	설명
`trident.netapp.io/configuratorStatus`	구성 결과 (`Success` 또는 `Failure`).
`trident.netapp.io/configuratorMessage`	자세한 구성 상태 또는 오류 메시지.
`trident.netapp.io/configuratorName`	내부 구성자 리소스 이름입니다.
`trident.netapp.io/managed`	해당 StorageClass가 Trident에서 관리됨을 나타냅니다.
`trident.netapp.io/additionalStoragePools`	이 백엔드용으로 생성된 스토리지 풀입니다.

trident.netapp.io/configuratorStatus

구성 결과 (Success 또는 Failure).

trident.netapp.io/configuratorMessage

자세한 구성 상태 또는 오류 메시지.

trident.netapp.io/configuratorName

내부 구성자 리소스 이름입니다.

trident.netapp.io/managed

해당 StorageClass가 Trident에서 관리됨을 나타냅니다.

trident.netapp.io/additionalStoragePools

이 백엔드용으로 생성된 스토리지 풀입니다.

구성이 성공하면 (configuratorStatus: Success, StorageClass가 완전히 작동합니다.

이제 다음을 수행할 수 있습니다.

이 StorageClass를 사용하여 PersistentVolumeClaims를 생성합니다
생성된 볼륨을 애플리케이션 워크로드에 마운트합니다

추가 FSxN 파일 시스템 추가

동일한 StorageClass를 계속 사용하면서 추가 스토리지 용량이 필요한 경우 NetApp ONTAP 파일 시스템용 FSx를 추가로 연결하십시오.

StorageClass를 편집합니다.

kubectl edit storageclass <storageclass-name>

추가 파일 시스템 ID로 주석을 추가하거나 업데이트합니다.

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

추가 파일 시스템을 포함하는 StorageClass의 예:

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

이 작업은 기존 StorageClass를 계속 사용하면서 추가 스토리지 용량을 추가합니다.

운영상의 고려사항 및 제한사항

StorageClass를 삭제하면 일반적으로 연결된 Trident 백엔드도 삭제됩니다.

이로 인해 스토리지 연결이 중단되고 실행 중인 워크로드가 중단될 수 있습니다.

관리형 StorageClass를 삭제하기 전에 잠재적 영향을 확인하십시오.

자동 백엔드 구성은 AWS FSx for NetApp ONTAP에서만 지원됩니다.