요청하신 자료를 사용할 수 없습니다. 이 버전의 제품에 적용되지 않거나 이 버전의 문서에서 관련 정보가 다르게 구성되어 있습니다. 제안 작업: 검색, 찾아보기 또는 다른 버전으로 돌아가기.

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

스토리지 클래스 구성

07/01/2026

PDF

이 "Kubernetes StorageClass 오브젝트" 설정은 프로비저너를 식별하고 프로비저너에게 볼륨을 프로비저닝하는 방법을 지시합니다. 이 섹션에서는 Trident를 프로비저너로 지정하는 Kubernetes StorageClass 객체를 구성하는 방법을 보여줍니다.

StorageClass 객체를 생성합니다

FSx for ONTAP용 StorageClass를 생성하면 Trident가 백엔드 구성을 자동으로 생성합니다.

스토리지 백엔드를 수동으로 구성하려면 Trident 백엔드와 스토리지 클래스를 별도로 생성하는 방법에 대한 [create-a-kubernetes-storageclass-without-automatic-backend-configuration] 섹션을 참조하십시오.

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

StorageClass를 생성할 때 다음 세 가지 매개 변수를 정의해야 합니다.

매개변수 필수 유형 설명

매개변수	필수	유형	설명
`fsxFilesystemID`	예	문자열	FSx for NetApp ONTAP 파일 시스템 ID
`storageDriverName`	예	문자열	Trident 스토리지 드라이버(예: `ontap-nas` 또는 `ontap-san`)
`credentialsName`	예	문자열	ONTAP 자격 증명용 FSx가 포함된 Kubernetes Secret의 이름

fsxFilesystemID

예

문자열

FSx for NetApp ONTAP 파일 시스템 ID

storageDriverName

예

문자열

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

credentialsName

예

문자열

ONTAP 자격 증명용 FSx가 포함된 Kubernetes Secret의 이름

선택적 매개변수 지정

StorageClass를 통해 선택적 백엔드 매개 변수를 전달할 수 있습니다. StorageClass parameters 섹션에서 모든 선택적 값을 문자열로 정의하십시오. 백엔드 매개변수의 전체 목록은 다음을 참조하십시오: "FSx for NetApp ONTAP 백엔드 구성".

StorageClass 구성 파일의 예입니다.

다음 예는 자동 백엔드 구성을 트리거하는 StorageClass를 보여줍니다.

YAML

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: ontap-fsx-demo
  annotations:
    description: "Demo StorageClass for FSx for NetApp ONTAP"
provisioner: csi.trident.netapp.io
parameters:
  fsxFilesystemID: "fs-0abc123"
  storageDriverName: "ontap-nas"
  credentialsName: trident-fsx-credentials
allowVolumeExpansion: true
reclaimPolicy: Delete
volumeBindingMode: Immediate

JSON

{
  "apiVersion": "storage.k8s.io/v1",
  "kind": "StorageClass",
  "metadata": {
    "name": "ontap-fsx-demo",
    "annotations": {
      "description": "Demo StorageClass for FSx for NetApp ONTAP"
    }
  },
  "provisioner": "csi.trident.netapp.io",
  "parameters": {
    "fsxFilesystemID": "fs-0abc123",
    "storageDriverName": "ontap-nas",
    "credentialsName": "trident-fsx-credentials"
  },
  "allowVolumeExpansion": true,
  "reclaimPolicy": "Delete",
  "volumeBindingMode": "Immediate"
}

StorageClass 생성

구성 파일을 생성한 후 다음 명령을 실행하여 스토리지 클래스를 생성하십시오.

kubectl create -f storage-class-ontapnas.yaml

이제 Kubernetes와 Trident 모두에서 basic-csi 스토리지 클래스가 표시되어야 하며, Trident가 백엔드에서 풀을 검색했을 것입니다.

kubectl get sc basic-csi

NAME         PROVISIONER             AGE
basic-csi    csi.trident.netapp.io   15h

StorageClass를 적용하면 Trident가 백엔드를 자동으로 생성합니다. 그런 다음, 이 StorageClass를 참조하는 PersistentVolumeClaims를 생성할 수 있습니다.

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

Trident는 백엔드 생성 결과를 StorageClass 어노테이션에 기록합니다.

주석 설명

주석	설명
`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

이 백엔드용으로 생성된 스토리지 풀

상태를 확인하려면 다음을 실행합니다.

kubectl get storageclass ontap-fsx-demo -o yaml

`trident.netapp.io/configuratorStatus`이(가)  `Success`(으)로 설정되어 있는지 확인하십시오. 값이  `Failure`인 경우 오류에 대해  `trident.netapp.io/configuratorMessage`을(를) 검토하십시오.

추가 FSxN 파일 시스템 추가

동일한 StorageClass를 계속 사용하면서 추가 스토리지 용량이 필요한 경우 추가 FSxN 파일 시스템 ID를 추가하십시오.

StorageClass를 편집하고 다음 주석을 추가하세요.

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

변경 사항을 적용하면 Trident가 백엔드 구성을 업데이트하고 StorageClass 어노테이션을 업데이트합니다.

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

자동 백엔드 구성이 있는 StorageClass를 삭제하면 일반적으로 연결된 Trident 백엔드도 함께 삭제됩니다. 이로 인해 스토리지 연결이 중단되고 실행 중인 워크로드가 중단될 수 있습니다. 관리형 StorageClass를 삭제하기 전에 영향을 검증하십시오.
자동 백엔드 구성은 AWS FSx for NetApp ONTAP에서만 지원됩니다.

자동 백엔드 구성 없이 Kubernetes StorageClass 생성

Trident 백엔드와 StorageClass를 별도로 생성하려면 다음 단계를 따르세요.

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

Trident는 StorageClass 정의에서 백엔드 구성을 가져옵니다. StorageClass를 적용하면 Trident는 필수 매개변수를 검증하고 백엔드를 생성한 다음 StorageClass에 상태 주석을 추가합니다.

Trident는 VolumeSnapshotClass를 한 번만 생성합니다. Trident는 이후의 StorageClasses에 대해 동일한 VolumeSnapshotClass를 재사용합니다.

Trident 백엔드를 생성합니다

Trident 백엔드를 생성하려면 JSON 또는 YAML 형식의 구성 파일을 만들어야 합니다. 이 파일에는 사용할 스토리지 유형(NAS 또는 SAN), 파일 시스템, 스토리지를 가져올 SVM, 그리고 인증 방법을 지정해야 합니다. 다음 예는 NAS 기반 스토리지를 정의하고 AWS 시크릿을 사용하여 사용할 SVM에 대한 자격 증명을 저장하는 방법을 보여줍니다.

YAML

apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
  name: backend-tbc-ontap-nas
  namespace: trident
spec:
  version: 1
  storageDriverName: ontap-nas
  backendName: tbc-ontap-nas
  svm: svm-name
  aws:
    fsxFilesystemID: fs-xxxxxxxxxx
  credentials:
    name: "arn:aws:secretsmanager:us-west-2:xxxxxxxx:secret:secret-name"
    type: awsarn

JSON

{
  "apiVersion": "trident.netapp.io/v1",
  "kind": "TridentBackendConfig",
  "metadata": {
    "name": "backend-tbc-ontap-nas"
    "namespace": "trident"
  },
  "spec": {
    "version": 1,
    "storageDriverName": "ontap-nas",
    "backendName": "tbc-ontap-nas",
    "svm": "svm-name",
    "aws": {
      "fsxFilesystemID": "fs-xxxxxxxxxx"
    },
    "managementLIF": null,
    "credentials": {
      "name": "arn:aws:secretsmanager:us-west-2:xxxxxxxx:secret:secret-name",
      "type": "awsarn"
    }
  }
}

FSx for ONTAP 드라이버 세부 정보

다음 드라이버를 사용하여 Trident를 Amazon FSx for NetApp ONTAP과 통합할 수 있습니다.

드라이버 이름 설명

드라이버 이름	설명
`ontap-san`	프로비저닝된 각 PV는 자체 Amazon FSx for NetApp ONTAP 볼륨 내의 LUN입니다. 블록 스토리지에 권장됩니다.
`ontap-nas`	프로비저닝된 각 PV는 전체 Amazon FSx for NetApp ONTAP 볼륨입니다. NFS 및 SMB에 권장됩니다.
`ontap-san-economy`	프로비저닝된 각 PV는 Amazon FSx for NetApp ONTAP 볼륨당 구성 가능한 LUN 수를 가진 LUN입니다.
`ontap-nas-economy`	프로비저닝된 각 PV는 qtree이며, Amazon FSx for NetApp ONTAP 볼륨당 구성 가능한 수의 qtree가 할당됩니다.
`ontap-nas-flexgroup`	프로비저닝된 각 PV는 Amazon FSx for NetApp ONTAP FlexGroup 볼륨입니다.

ontap-san

프로비저닝된 각 PV는 자체 Amazon FSx for NetApp ONTAP 볼륨 내의 LUN입니다. 블록 스토리지에 권장됩니다.

ontap-nas

프로비저닝된 각 PV는 전체 Amazon FSx for NetApp ONTAP 볼륨입니다. NFS 및 SMB에 권장됩니다.

ontap-san-economy

프로비저닝된 각 PV는 Amazon FSx for NetApp ONTAP 볼륨당 구성 가능한 LUN 수를 가진 LUN입니다.

ontap-nas-economy

프로비저닝된 각 PV는 qtree이며, Amazon FSx for NetApp ONTAP 볼륨당 구성 가능한 수의 qtree가 할당됩니다.

ontap-nas-flexgroup

프로비저닝된 각 PV는 Amazon FSx for NetApp ONTAP FlexGroup 볼륨입니다.

드라이버 세부 정보는 "NAS 드라이버" 및 "SAN 드라이버"을 참조하십시오.

백엔드 생성

구성 파일을 생성한 후 다음 명령을 실행하여 Trident 백엔드 구성(TBC)을 생성하고 유효성을 검사하십시오.

YAML 파일에서 Trident 백엔드 구성(TBC)을 생성하고 다음 명령을 실행하십시오.

kubectl create -f backendconfig.yaml -n trident

tridentbackendconfig.trident.netapp.io/backend-tbc-ontap-nas created

Trident 백엔드 구성(TBC)이 성공적으로 생성되었는지 확인합니다.

Kubectl get tbc -n trident

NAME                         BACKEND NAME         BACKEND UUID                           PHASE   STATUS

backend-tbc-ontap-nas        tbc-ontap-nas        933e0071-66ce-4324-b9ff-f96d916ac5e9   Bound   Success

다른 구성 옵션에 대한 자세한 내용은 아래 [Backend-advanced-configuration-and-examples] 섹션을 참조하십시오.

자동 백엔드 구성 없이 스토리지 클래스 구성

다음은 Trident 및 FSx for ONTAP에서 사용할 스토리지 클래스 구성의 예입니다.

NFS용 스토리지 클래스

이 예제를 사용하여 NFS를 사용하는 볼륨에 대한 StorageClass를 설정할 수 있습니다(전체 속성 목록은 아래 Trident 속성 섹션을 참조하십시오).

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: ontap-gold
provisioner: csi.trident.netapp.io
parameters:
  backendType: "ontap-nas"
  provisioningType: "thin"
  snapshots: "true"

iSCSI용 스토리지 클래스

iSCSI를 사용하여 볼륨에 대한 StorageClass를 설정하려면 다음 예를 사용하십시오.

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: ontap-gold
provisioner: csi.trident.netapp.io
parameters:
  backendType: "ontap-san"
  provisioningType: "thin"
  snapshots: "true"

NFSv3 및 AWS Bottlerocket을 사용하는 스토리지 클래스

AWS Bottlerocket에서 NFSv3 볼륨을 프로비저닝하려면 스토리지 클래스에 필요한 `mountOptions`을(를) 추가하십시오.

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: ontap-gold
provisioner: csi.trident.netapp.io
parameters:
  backendType: "ontap-nas"
  media: "ssd"
  provisioningType: "thin"
  snapshots: "true"
mountOptions:
  - nfsvers=3
  - nolock

Trident StorageClass 속성

이러한 매개변수는 특정 유형의 볼륨을 프로비저닝하는 데 사용할 Trident 관리 스토리지 풀을 결정합니다.

속성	유형	값	제공	요청	지원 대상:
미디어¹	문자열	HDD, 하이브리드, SSD	풀에는 이러한 유형의 미디어가 포함되어 있습니다. 하이브리드는 둘 다를 의미합니다	지정된 미디어 유형	ontap-nas, ontap-nas-economy, ontap-nas-flexgroup, ontap-san, solidfire-san
provisioningType	문자열	씬, 씩	풀은 이 프로비저닝 방식을 지원합니다	프로비저닝 방법이 지정되었습니다	thick: 모든 ONTAP, thin: 모든 ONTAP 및 SolidFire-SAN
backendType	문자열	ontap-nas, ontap-nas-economy, ontap-nas-flexgroup, ontap-san, solidfire-san, azure-netapp-files, ontap-san-economy	풀은 이러한 유형의 백엔드에 속합니다	지정된 백엔드	모든 드라이버
스냅샷	불	참, 거짓	풀은 스냅샷이 있는 볼륨을 지원합니다	스냅샷이 활성화된 볼륨	ontap-nas, ontap-san, solidfire-san
클론	불	참, 거짓	풀은 볼륨 복제를 지원합니다	클론이 활성화된 볼륨	ontap-nas, ontap-san, solidfire-san
암호화	불	참, 거짓	스토리지 풀은 암호화된 볼륨을 지원합니다.	암호화가 설정된 볼륨	ontap-nas, ontap-nas-economy, ontap-nas-flexgroups, ontap-san
IOPS	int	양의 정수	풀은 이 범위의 IOPS를 보장할 수 있습니다	볼륨에서 이러한 IOPS를 보장합니다	SolidFire-SAN

속성

유형

값

제공

요청

지원 대상:

미디어¹

문자열

HDD, 하이브리드, SSD

풀에는 이러한 유형의 미디어가 포함되어 있습니다. 하이브리드는 둘 다를 의미합니다

지정된 미디어 유형

ontap-nas, ontap-nas-economy, ontap-nas-flexgroup, ontap-san, solidfire-san

provisioningType

문자열

씬, 씩

풀은 이 프로비저닝 방식을 지원합니다

프로비저닝 방법이 지정되었습니다

thick: 모든 ONTAP, thin: 모든 ONTAP 및 SolidFire-SAN

backendType

문자열

ontap-nas, ontap-nas-economy, ontap-nas-flexgroup, ontap-san, solidfire-san, azure-netapp-files, ontap-san-economy

풀은 이러한 유형의 백엔드에 속합니다

지정된 백엔드

모든 드라이버

스냅샷

불

참, 거짓

풀은 스냅샷이 있는 볼륨을 지원합니다

스냅샷이 활성화된 볼륨

ontap-nas, ontap-san, solidfire-san

클론

불

참, 거짓

풀은 볼륨 복제를 지원합니다

클론이 활성화된 볼륨

ontap-nas, ontap-san, solidfire-san

암호화

불

참, 거짓

스토리지 풀은 암호화된 볼륨을 지원합니다.

암호화가 설정된 볼륨

ontap-nas, ontap-nas-economy, ontap-nas-flexgroups, ontap-san

IOPS

int

양의 정수

풀은 이 범위의 IOPS를 보장할 수 있습니다

볼륨에서 이러한 IOPS를 보장합니다

SolidFire-SAN

¹: ONTAP Select 또는 FSx for ONTAP 시스템에서 지원되지 않습니다

스토리지 클래스가 "Kubernetes 및 Trident 객체"와 상호 작용하는 방법 및 Trident가 볼륨을 프로비저닝하는 방식을 제어하는 매개변수에 대한 자세한 내용은 `PersistentVolumeClaim`를 참조하십시오.

스토리지 클래스를 생성합니다

StorageClass를 구성한 후 Kubernetes에서 생성할 수 있습니다.

단계

이것은 Kubernetes 객체이므로 `kubectl`을 사용하여 Kubernetes에서 생성합니다.
```
kubectl create -f storage-class-ontapnas.yaml
```
이제 Kubernetes와 Trident 모두에서 basic-csi 스토리지 클래스가 표시되어야 하며, Trident가 백엔드에서 풀을 검색했을 것입니다.
```
kubectl get sc basic-csi
```

NAME         PROVISIONER             AGE
basic-csi    csi.trident.netapp.io   15h

SMB 볼륨 프로비저닝

`ontap-nas` 드라이버를 사용하여 SMB 볼륨을 프로비저닝할 수 있습니다. 하지만 그러려면 다음 단계를 완료해야 합니다: link:worker-node-prep.html#prepare-to-provision-smb-volumes["SMB 볼륨 프로비저닝 준비"].

백엔드 고급 구성 및 예

백엔드 구성 옵션은 다음 표를 참조하십시오.

매개변수 설명 예

매개변수	설명	예
`version`		항상 1
`storageDriverName`	스토리지 드라이버의 이름	`ontap-nas`, `ontap-nas-economy`, `ontap-nas-flexgroup`, `ontap-san`, `ontap-san-economy`
`backendName`	사용자 지정 이름 또는 스토리지 백엔드	드라이버 이름 + "_" + dataLIF
`managementLIF`	클러스터 또는 SVM 관리 LIF의 IP 주소입니다. 정규화된 도메인 이름(FQDN)도 지정할 수 있습니다. Trident를 IPv6 플래그를 사용하여 설치한 경우 IPv6 주소를 사용하도록 설정할 수 있습니다. IPv6 주소는 [28e8:d9fb:a825:b7bf:69a8:d02f:9e7b:3555]와 같이 대괄호 안에 정의해야 합니다. 만약 fsxFilesystemID`를 `aws 필드에 제공하면 managementLIF`를 제공할 필요가 없습니다. Trident가 AWS에서 SVM `managementLIF 정보를 가져오기 때문입니다. 따라서 SVM(예: vsadmin) 아래의 사용자에 대한 자격 증명을 제공해야 하며, 해당 사용자는 `vsadmin` 역할을 가지고 있어야 합니다.	"10.0.0.1", "[2001:1234:abcd::fefe]"
`dataLIF`	프로토콜 LIF의 IP 주소입니다. * ONTAP NAS 드라이버: NetApp dataLIF를 지정하는 것을 권장합니다. 지정하지 않으면 Trident는 SVM에서 dataLIF를 가져옵니다. NFS 마운트 작업에 사용할 정규화된 도메인 이름(FQDN)을 지정하여 여러 dataLIF에 걸쳐 로드 밸런싱을 수행하는 라운드 로빈 DNS를 구성할 수 있습니다. 초기 설정 후 변경할 수 있습니다. ONTAP SAN 드라이버*: iSCSI의 경우 지정하지 마십시오. Trident는 ONTAP 선택적 LUN 맵을 사용하여 멀티 패스 세션을 설정하는 데 필요한 iSCSI LIF를 검색합니다. dataLIF가 명시적으로 정의된 경우 경고가 생성됩니다. Trident를 IPv6 플래그를 사용하여 설치한 경우 IPv6 주소를 사용하도록 설정할 수 있습니다. IPv6 주소는 [28e8:d9fb:a825:b7bf:69a8:d02f:9e7b:3555]와 같이 대괄호 안에 정의해야 합니다.
`autoExportPolicy`	자동 엑스포트 정책 생성 및 업데이트를 활성화합니다[Boolean]. `autoExportPolicy` 및 `autoExportCIDRs` 옵션을 사용하면 Trident가 내보내기 정책을 자동으로 관리할 수 있습니다.	`false`
`autoExportCIDRs`	autoExportPolicy`이 활성화된 경우 Kubernetes 노드 IP를 필터링하는 데 사용할 CIDR 목록입니다. `autoExportPolicy 및 `autoExportCIDRs` 옵션을 사용하면 Trident가 내보내기 정책을 자동으로 관리할 수 있습니다.	"["0.0.0.0/0", "::/0"]"
`labels`	볼륨에 적용할 임의의 JSON 형식 레이블 세트	""
`clientCertificate`	클라이언트 인증서의 Base64 인코딩 값입니다. 인증서 기반 인증에 사용됩니다	""
`clientPrivateKey`	클라이언트 개인 키를 Base64로 인코딩한 값입니다. 인증서 기반 인증에 사용됩니다	""
`trustedCACertificate`	신뢰할 수 있는 CA 인증서의 Base64 인코딩 값입니다. 선택 사항입니다. 인증서 기반 인증에 사용됩니다.	""
`username`	클러스터 또는 SVM에 연결하는 데 사용할 사용자 이름입니다. 자격 증명 기반 인증에 사용됩니다. 예: vsadmin.
`password`	클러스터 또는 SVM에 연결하는 데 사용되는 비밀번호입니다. 자격 증명 기반 인증에 사용됩니다.
`svm`	사용할 스토리지 가상 머신	SVM 관리 LIF가 지정된 경우 파생됩니다.
`storagePrefix`	SVM에서 새 볼륨을 프로비저닝할 때 사용되는 접두사입니다. 생성 후에는 수정할 수 없습니다. 이 매개 변수를 업데이트하려면 새 백엔드를 생성해야 합니다.	`trident`
`limitAggregateUsage`	Amazon FSx for NetApp ONTAP에는 지정하지 마십시오. 제공된 `fsxadmin` 및 `vsadmin`에는 Trident를 사용하여 애그리게이트 사용량을 검색하고 제한하는 데 필요한 권한이 포함되어 있지 않습니다.	사용하지 마십시오.
`limitVolumeSize`	요청된 볼륨 크기가 이 값을 초과하면 프로비저닝이 실패합니다. 또한 관리하는 qtree 및 LUN의 최대 크기를 제한하며, `qtreesPerFlexvol` 옵션을 통해 FlexVol 볼륨당 최대 qtree 수를 사용자 지정할 수 있습니다.	"" (기본적으로 적용되지 않음)
`lunsPerFlexvol`	FlexVol 볼륨당 최대 LUN 수는 [50, 200] 범위 내에 있어야 합니다. SAN 전용입니다.	“100”
`debugTraceFlags`	문제 해결 시 사용할 디버그 플래그입니다. 예, {"api":false, "method":true} 문제 해결 중이거나 자세한 로그 덤프가 필요한 경우가 아니면 `debugTraceFlags` 사용하지 마십시오.	null
`nfsMountOptions`	쉼표로 구분된 NFS 마운트 옵션 목록입니다. Kubernetes 영구 볼륨의 마운트 옵션은 일반적으로 스토리지 클래스에 지정되지만, 스토리지 클래스에 마운트 옵션이 지정되지 않은 경우 Trident는 스토리지 백엔드의 구성 파일에 지정된 마운트 옵션을 사용합니다. 스토리지 클래스 또는 구성 파일에 마운트 옵션이 지정되지 않은 경우 Trident는 연결된 영구 볼륨에 마운트 옵션을 설정하지 않습니다.	""
`nasType`	NFS 또는 SMB 볼륨 생성을 구성합니다. 옵션은 `nfs`, `smb` 또는 null입니다. SMB 볼륨의 경우 `smb`로 설정해야 합니다. null로 설정하면 기본적으로 NFS 볼륨이 사용됩니다.	`nfs`
`qtreesPerFlexvol`	FlexVol 볼륨당 최대 Qtree 수는 [50, 300] 범위 내에 있어야 합니다.	`"200"`
`smbShare`	다음 중 하나를 지정할 수 있습니다. Microsoft Management Console 또는 ONTAP CLI를 사용하여 생성한 SMB 공유의 이름 또는 Trident가 SMB 공유를 생성할 수 있도록 허용하는 이름입니다. 이 매개 변수는 Amazon FSx for NetApp ONTAP 백엔드에 필수입니다.	`smb-share`
`useREST`	ONTAP REST API를 사용하기 위한 부울 매개 변수입니다. true`로 설정하면 Trident는 ONTAP REST API를 사용하여 백엔드와 통신합니다. 이 기능을 사용하려면 ONTAP 9.11.1 이상이 필요합니다. 또한 사용되는 ONTAP 로그인 역할은 `ontap 애플리케이션에 대한 액세스 권한이 있어야 합니다. 이는 사전 정의된 `vsadmin` 및 `cluster-admin` 역할로 충족됩니다.	`false`
`aws`	AWS FSx for ONTAP의 구성 파일에서 다음을 지정할 수 있습니다. - `fsxFilesystemID`: AWS FSx 파일 시스템의 ID를 지정합니다. - `apiRegion`: AWS API 리전 이름입니다. - `apikey`: AWS API 키입니다. - `secretKey`: AWS 비밀 키입니다.	`""` `""` `""`
`credentials`	AWS Secrets Manager에 저장할 FSx SVM 자격 증명을 지정합니다. - `name`: SVM 자격 증명이 포함된 시크릿의 Amazon 리소스 이름(ARN)입니다. - `type`: `awsarn`로 설정합니다. 자세한 내용은 "AWS Secrets Manager 암호를 생성합니다"을 참조하십시오.

version

항상 1

storageDriverName

스토리지 드라이버의 이름

ontap-nas, ontap-nas-economy, ontap-nas-flexgroup, ontap-san, ontap-san-economy

backendName

사용자 지정 이름 또는 스토리지 백엔드

드라이버 이름 + "_" + dataLIF

managementLIF

클러스터 또는 SVM 관리 LIF의 IP 주소입니다. 정규화된 도메인 이름(FQDN)도 지정할 수 있습니다. Trident를 IPv6 플래그를 사용하여 설치한 경우 IPv6 주소를 사용하도록 설정할 수 있습니다. IPv6 주소는 [28e8:d9fb:a825:b7bf:69a8:d02f:9e7b:3555]와 같이 대괄호 안에 정의해야 합니다. 만약 fsxFilesystemID`를 `aws 필드에 제공하면 managementLIF`를 제공할 필요가 없습니다. Trident가 AWS에서 SVM `managementLIF 정보를 가져오기 때문입니다. 따라서 SVM(예: vsadmin) 아래의 사용자에 대한 자격 증명을 제공해야 하며, 해당 사용자는 vsadmin 역할을 가지고 있어야 합니다.

"10.0.0.1", "[2001:1234:abcd::fefe]"

dataLIF

프로토콜 LIF의 IP 주소입니다. * ONTAP NAS 드라이버*: NetApp dataLIF를 지정하는 것을 권장합니다. 지정하지 않으면 Trident는 SVM에서 dataLIF를 가져옵니다. NFS 마운트 작업에 사용할 정규화된 도메인 이름(FQDN)을 지정하여 여러 dataLIF에 걸쳐 로드 밸런싱을 수행하는 라운드 로빈 DNS를 구성할 수 있습니다. 초기 설정 후 변경할 수 있습니다. * ONTAP SAN 드라이버*: iSCSI의 경우 지정하지 마십시오. Trident는 ONTAP 선택적 LUN 맵을 사용하여 멀티 패스 세션을 설정하는 데 필요한 iSCSI LIF를 검색합니다. dataLIF가 명시적으로 정의된 경우 경고가 생성됩니다. Trident를 IPv6 플래그를 사용하여 설치한 경우 IPv6 주소를 사용하도록 설정할 수 있습니다. IPv6 주소는 [28e8:d9fb:a825:b7bf:69a8:d02f:9e7b:3555]와 같이 대괄호 안에 정의해야 합니다.

autoExportPolicy

자동 엑스포트 정책 생성 및 업데이트를 활성화합니다[Boolean]. autoExportPolicy 및 autoExportCIDRs 옵션을 사용하면 Trident가 내보내기 정책을 자동으로 관리할 수 있습니다.

false

autoExportCIDRs

autoExportPolicy`이 활성화된 경우 Kubernetes 노드 IP를 필터링하는 데 사용할 CIDR 목록입니다. `autoExportPolicy 및 autoExportCIDRs 옵션을 사용하면 Trident가 내보내기 정책을 자동으로 관리할 수 있습니다.

"["0.0.0.0/0", "::/0"]"

labels

볼륨에 적용할 임의의 JSON 형식 레이블 세트

clientCertificate

클라이언트 인증서의 Base64 인코딩 값입니다. 인증서 기반 인증에 사용됩니다

clientPrivateKey

클라이언트 개인 키를 Base64로 인코딩한 값입니다. 인증서 기반 인증에 사용됩니다

trustedCACertificate

신뢰할 수 있는 CA 인증서의 Base64 인코딩 값입니다. 선택 사항입니다. 인증서 기반 인증에 사용됩니다.

username

클러스터 또는 SVM에 연결하는 데 사용할 사용자 이름입니다. 자격 증명 기반 인증에 사용됩니다. 예: vsadmin.

password

클러스터 또는 SVM에 연결하는 데 사용되는 비밀번호입니다. 자격 증명 기반 인증에 사용됩니다.

svm

사용할 스토리지 가상 머신

SVM 관리 LIF가 지정된 경우 파생됩니다.

storagePrefix

SVM에서 새 볼륨을 프로비저닝할 때 사용되는 접두사입니다. 생성 후에는 수정할 수 없습니다. 이 매개 변수를 업데이트하려면 새 백엔드를 생성해야 합니다.

trident

limitAggregateUsage

Amazon FSx for NetApp ONTAP에는 지정하지 마십시오. 제공된 fsxadmin 및 `vsadmin`에는 Trident를 사용하여 애그리게이트 사용량을 검색하고 제한하는 데 필요한 권한이 포함되어 있지 않습니다.

사용하지 마십시오.

limitVolumeSize

요청된 볼륨 크기가 이 값을 초과하면 프로비저닝이 실패합니다. 또한 관리하는 qtree 및 LUN의 최대 크기를 제한하며, qtreesPerFlexvol 옵션을 통해 FlexVol 볼륨당 최대 qtree 수를 사용자 지정할 수 있습니다.

"" (기본적으로 적용되지 않음)

lunsPerFlexvol

FlexVol 볼륨당 최대 LUN 수는 [50, 200] 범위 내에 있어야 합니다. SAN 전용입니다.

“100”

debugTraceFlags

문제 해결 시 사용할 디버그 플래그입니다. 예, {"api":false, "method":true} 문제 해결 중이거나 자세한 로그 덤프가 필요한 경우가 아니면 debugTraceFlags 사용하지 마십시오.

null

nfsMountOptions

쉼표로 구분된 NFS 마운트 옵션 목록입니다. Kubernetes 영구 볼륨의 마운트 옵션은 일반적으로 스토리지 클래스에 지정되지만, 스토리지 클래스에 마운트 옵션이 지정되지 않은 경우 Trident는 스토리지 백엔드의 구성 파일에 지정된 마운트 옵션을 사용합니다. 스토리지 클래스 또는 구성 파일에 마운트 옵션이 지정되지 않은 경우 Trident는 연결된 영구 볼륨에 마운트 옵션을 설정하지 않습니다.

nasType

NFS 또는 SMB 볼륨 생성을 구성합니다. 옵션은 nfs, smb 또는 null입니다. SMB 볼륨의 경우 `smb`로 설정해야 합니다. null로 설정하면 기본적으로 NFS 볼륨이 사용됩니다.

nfs

qtreesPerFlexvol

FlexVol 볼륨당 최대 Qtree 수는 [50, 300] 범위 내에 있어야 합니다.

"200"

smbShare

다음 중 하나를 지정할 수 있습니다. Microsoft Management Console 또는 ONTAP CLI를 사용하여 생성한 SMB 공유의 이름 또는 Trident가 SMB 공유를 생성할 수 있도록 허용하는 이름입니다. 이 매개 변수는 Amazon FSx for NetApp ONTAP 백엔드에 필수입니다.

smb-share

useREST

ONTAP REST API를 사용하기 위한 부울 매개 변수입니다. true`로 설정하면 Trident는 ONTAP REST API를 사용하여 백엔드와 통신합니다. 이 기능을 사용하려면 ONTAP 9.11.1 이상이 필요합니다. 또한 사용되는 ONTAP 로그인 역할은 `ontap 애플리케이션에 대한 액세스 권한이 있어야 합니다. 이는 사전 정의된 vsadmin 및 cluster-admin 역할로 충족됩니다.

false

aws

AWS FSx for ONTAP의 구성 파일에서 다음을 지정할 수 있습니다. - fsxFilesystemID: AWS FSx 파일 시스템의 ID를 지정합니다. - apiRegion: AWS API 리전 이름입니다. - apikey: AWS API 키입니다. - secretKey: AWS 비밀 키입니다.

""
""
""

credentials

AWS Secrets Manager에 저장할 FSx SVM 자격 증명을 지정합니다. - name: SVM 자격 증명이 포함된 시크릿의 Amazon 리소스 이름(ARN)입니다. - type: `awsarn`로 설정합니다. 자세한 내용은 "AWS Secrets Manager 암호를 생성합니다"을 참조하십시오.

볼륨 프로비저닝을 위한 백엔드 구성 옵션

구성의 defaults 섹션에서 이러한 옵션을 사용하여 기본 프로비저닝을 제어할 수 있습니다. 예를 들어, 아래 구성 예를 참조하십시오.

매개변수 설명 기본값

매개변수	설명	기본값
`spaceAllocation`	LUN의 공간 할당	`true`
`spaceReserve`	공간 예약 모드, "none"(씬) 또는 "volume"(씩)	`none`
`snapshotPolicy`	사용할 스냅샷 정책	`none`
`qosPolicy`	생성된 볼륨에 할당할 QoS 정책 그룹입니다. 스토리지 풀 또는 백엔드별로 qosPolicy 또는 adaptiveQosPolicy 중 하나를 선택하십시오. Trident에서 QoS 정책 그룹을 사용하려면 ONTAP 9.8 이상이 필요합니다. 공유되지 않는 QoS 정책 그룹을 사용하고 정책 그룹이 각 구성 요소에 개별적으로 적용되도록 해야 합니다. 공유 QoS 정책 그룹은 모든 워크로드의 총 처리량에 대한 상한선을 적용합니다.	""
`adaptiveQosPolicy`	생성된 볼륨에 할당할 적응형 QoS 정책 그룹입니다. 스토리지 풀 또는 백엔드별로 qosPolicy 또는 adaptiveQosPolicy 중 하나를 선택하십시오. ontap-nas-economy에서는 지원되지 않습니다.	""
`snapshotReserve`	스냅샷용으로 예약된 볼륨의 비율 "0"	snapshotPolicy`이 `none`인 경우, `else ""
`splitOnClone`	생성 시 상위 항목에서 클론 분할	`false`
`encryption`	새 볼륨에서 NetApp Volume Encryption(NVE)을 활성화합니다. 기본값은 `false`입니다. 이 옵션을 사용하려면 클러스터에서 NVE 라이센스가 있고 활성화되어 있어야 합니다. 백엔드에서 NAE가 활성화된 경우 Trident에서 프로비저닝된 모든 볼륨은 NAE가 활성화됩니다. 자세한 내용은 다음을 참조하십시오. "Trident가 NVE 및 NAE와 작동하는 방식"	`false`
`luksEncryption`	LUKS 암호화를 활성화합니다. 다음을 참조하십시오. "Linux Unified Key Setup(LUKS) 사용". SAN 전용입니다.	""
`tieringPolicy`	사용할 계층화 정책 `none`
`unixPermissions`	새 볼륨 모드입니다. SMB 볼륨의 경우 비워 두십시오.	""
`securityStyle`	새 볼륨에 대한 보안 스타일입니다. NFS는 `mixed` 및 `unix` 보안 스타일을 지원합니다. SMB는 `mixed` 및 `ntfs` 보안 스타일을 지원합니다.	NFS 기본값은 `unix`입니다. SMB 기본값은 `ntfs`입니다.

spaceAllocation

LUN의 공간 할당

true

spaceReserve

공간 예약 모드, "none"(씬) 또는 "volume"(씩)

none

snapshotPolicy

사용할 스냅샷 정책

none

qosPolicy

생성된 볼륨에 할당할 QoS 정책 그룹입니다. 스토리지 풀 또는 백엔드별로 qosPolicy 또는 adaptiveQosPolicy 중 하나를 선택하십시오. Trident에서 QoS 정책 그룹을 사용하려면 ONTAP 9.8 이상이 필요합니다. 공유되지 않는 QoS 정책 그룹을 사용하고 정책 그룹이 각 구성 요소에 개별적으로 적용되도록 해야 합니다. 공유 QoS 정책 그룹은 모든 워크로드의 총 처리량에 대한 상한선을 적용합니다.

adaptiveQosPolicy

생성된 볼륨에 할당할 적응형 QoS 정책 그룹입니다. 스토리지 풀 또는 백엔드별로 qosPolicy 또는 adaptiveQosPolicy 중 하나를 선택하십시오. ontap-nas-economy에서는 지원되지 않습니다.

snapshotReserve

스냅샷용으로 예약된 볼륨의 비율 "0"

snapshotPolicy`이 `none`인 경우, `else ""

splitOnClone

생성 시 상위 항목에서 클론 분할

false

encryption

새 볼륨에서 NetApp Volume Encryption(NVE)을 활성화합니다. 기본값은 `false`입니다. 이 옵션을 사용하려면 클러스터에서 NVE 라이센스가 있고 활성화되어 있어야 합니다. 백엔드에서 NAE가 활성화된 경우 Trident에서 프로비저닝된 모든 볼륨은 NAE가 활성화됩니다. 자세한 내용은 다음을 참조하십시오. "Trident가 NVE 및 NAE와 작동하는 방식"

false

luksEncryption

LUKS 암호화를 활성화합니다. 다음을 참조하십시오. "Linux Unified Key Setup(LUKS) 사용". SAN 전용입니다.

tieringPolicy

사용할 계층화 정책 none

unixPermissions

새 볼륨 모드입니다. SMB 볼륨의 경우 비워 두십시오.

securityStyle

새 볼륨에 대한 보안 스타일입니다. NFS는 mixed 및 unix 보안 스타일을 지원합니다. SMB는 mixed 및 ntfs 보안 스타일을 지원합니다.

NFS 기본값은 `unix`입니다. SMB 기본값은 `ntfs`입니다.

스토리지 클래스 구성

Creating your file...

StorageClass 객체를 생성합니다

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

선택적 매개변수 지정

StorageClass 구성 파일의 예입니다.

StorageClass 생성

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

추가 FSxN 파일 시스템 추가

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

자동 백엔드 구성 없이 Kubernetes StorageClass 생성

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

Trident 백엔드를 생성합니다

FSx for ONTAP 드라이버 세부 정보

백엔드 생성

자동 백엔드 구성 없이 스토리지 클래스 구성

NFS용 스토리지 클래스

iSCSI용 스토리지 클래스

NFSv3 및 AWS Bottlerocket을 사용하는 스토리지 클래스

Trident StorageClass 속성

스토리지 클래스를 생성합니다

SMB 볼륨 프로비저닝

백엔드 고급 구성 및 예

볼륨 프로비저닝을 위한 백엔드 구성 옵션