本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

FSX提供ONTAP 各種組態選項和範例

06/28/2024 貢獻者

PDF

深入瞭解Amazon FSX for ONTAP Sfor Sf。本節提供後端組態範例。

後端組態選項

如需後端組態選項、請參閱下表：

參數說明範例

參數	說明	範例
`version`		永遠為1
`storageDriverName`	儲存驅動程式名稱	`ontap-nas`、 `ontap-nas-economy`、 `ontap-nas-flexgroup`、 `ontap-san`、 `ontap-san-economy`
`backendName`	自訂名稱或儲存後端	驅動程式名稱+「_」+ dataLIF
`managementLIF`	叢集或SVM管理LIF的IP位址您可以指定完整網域名稱（FQDN）。如果使用 IPv6 旗標安裝 Astra Trident 、則可以設定為使用 IPv6 位址。IPv6位址必須以方括弧來定義、例如[28e8：d9fb：a825：b7bf：69a8：d02f：9e7b：3555]。	「10.0.0.1」、「[2001:1234:abcd:::fefo]」
`dataLIF`	傳輸協定LIF的IP位址。不適用NAS驅動程式：建議您指定dataLIF ONTAP 。如果未提供、Astra Trident會從SVM擷取資料lifs。您可以指定要用於NFS掛載作業的完整網域名稱（FQDN）、讓您建立循環配置資源DNS、以便在多個資料生命期之間達到負載平衡。可在初始設定之後變更。請參閱。《SAN驅動程式：請勿指定用於iSCSI》ONTAP 。Astra Trident使用ONTAP 「選擇性LUN地圖」來探索建立多重路徑工作階段所需的iSCI lifs。如果明確定義dataLIF、就會產生警告。如果使用 IPv6 旗標安裝 Astra Trident 、則可以設定為使用 IPv6 位址。IPv6位址必須以方括弧來定義、例如[28e8：d9fb：a825：b7bf：69a8：d02f：9e7b：3555]。
`autoExportPolicy`	啟用自動匯出原則建立及更新[布林值]。使用 `autoExportPolicy` 和 `autoExportCIDRs` 選項：Astra Trident可自動管理匯出原則。	`false`
`autoExportCIDRs`	篩選 Kubernetes 節點 IP 的 CIDR 清單、以對抗時間 `autoExportPolicy` 已啟用。使用 `autoExportPolicy` 和 `autoExportCIDRs` 選項：Astra Trident可自動管理匯出原則。	「[「0.00.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` 請勿包含擷取Aggregate使用量所需的權限、並使用Astra Trident加以限制。	請勿使用。
`limitVolumeSize`	如果要求的磁碟區大小高於此值、則資源配置失敗。也會限制其管理的qtree和LUN、以及的磁碟區大小上限 `qtreesPerFlexvol` 選項可自訂每FlexVol 個支援區的配額樹數上限。	「」（預設不強制執行）
`lunsPerFlexvol`	每FlexVol 個LUN的最大LUN數量、範圍必須為[50、200]。僅限 SAN 。	`100`
`debugTraceFlags`	疑難排解時要使用的偵錯旗標。範例：｛"API"：假、「方法」：true｝請勿使用 `debugTraceFlags` 除非您正在疑難排解並需要詳細的記錄傾印。	null
`nfsMountOptions`	以逗號分隔的NFS掛載選項清單。 Kubernetes持續磁碟區的掛載選項通常會在儲存類別中指定、但如果儲存類別中未指定掛載選項、則Astra Trident會改回使用儲存後端組態檔中指定的掛載選項。如果儲存類別或組態檔中未指定掛載選項、Astra Trident將不會在相關的持續磁碟區上設定任何掛載選項。	"
`nasType`	設定NFS或SMB磁碟區建立。選項包括 `nfs`、 smb`或null。必須設定為 `smb 對於SMB Volume。設定為null、預設為NFS Volume。	`nfs`
`qtreesPerFlexvol`	每FlexVol 個邊的最大qtree數、必須在範圍內[50、300]	`200`
`smbShare`	您可以指定下列其中一項：使用 Microsoft 管理主控台或 ONTAP CLI 建立的 SMB 共用名稱、或是允許 Astra Trident 建立 SMB 共用的名稱。 ONTAP 後端的 Amazon FSX 需要此參數。	`smb-share`
`useREST`	使用ONTAP Isrest API的布林參數。技術預覽 `useREST` 以技術預覽的形式提供、建議用於測試環境、而非用於正式作業工作負載。設定為時 `true`、Astra Trident將使用ONTAP 靜止API與後端進行通訊。此功能需要ONTAP 使用更新版本的版本。此外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 Secret Manager 中的 FSX SVM 認證。 - `name`：機密的 Amazon 資源名稱（ ARN ）、其中包含 SVM 的認證。 - `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）。

如果使用 IPv6 旗標安裝 Astra Trident 、則可以設定為使用 IPv6 位址。IPv6位址必須以方括弧來定義、例如[28e8：d9fb：a825：b7bf：69a8：d02f：9e7b：3555]。

「10.0.0.1」、「[2001:1234:abcd:::fefo]」

dataLIF

傳輸協定LIF的IP位址。

不適用NAS驅動程式：建議您指定dataLIF ONTAP 。如果未提供、Astra Trident會從SVM擷取資料lifs。您可以指定要用於NFS掛載作業的完整網域名稱（FQDN）、讓您建立循環配置資源DNS、以便在多個資料生命期之間達到負載平衡。可在初始設定之後變更。請參閱。

《SAN驅動程式：請勿指定用於iSCSI》ONTAP 。Astra Trident使用ONTAP 「選擇性LUN地圖」來探索建立多重路徑工作階段所需的iSCI lifs。如果明確定義dataLIF、就會產生警告。

如果使用 IPv6 旗標安裝 Astra Trident 、則可以設定為使用 IPv6 位址。IPv6位址必須以方括弧來定義、例如[28e8：d9fb：a825：b7bf：69a8：d02f：9e7b：3555]。

autoExportPolicy

啟用自動匯出原則建立及更新[布林值]。

使用 autoExportPolicy 和 autoExportCIDRs 選項：Astra Trident可自動管理匯出原則。

false

autoExportCIDRs

篩選 Kubernetes 節點 IP 的 CIDR 清單、以對抗時間 autoExportPolicy 已啟用。

使用 autoExportPolicy 和 autoExportCIDRs 選項：Astra Trident可自動管理匯出原則。

「[「0.00.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 請勿包含擷取Aggregate使用量所需的權限、並使用Astra Trident加以限制。

請勿使用。

limitVolumeSize

如果要求的磁碟區大小高於此值、則資源配置失敗。

也會限制其管理的qtree和LUN、以及的磁碟區大小上限 qtreesPerFlexvol 選項可自訂每FlexVol 個支援區的配額樹數上限。

「」（預設不強制執行）

lunsPerFlexvol

每FlexVol 個LUN的最大LUN數量、範圍必須為[50、200]。

僅限 SAN 。

100

debugTraceFlags

疑難排解時要使用的偵錯旗標。範例：｛"API"：假、「方法」：true｝

請勿使用 debugTraceFlags 除非您正在疑難排解並需要詳細的記錄傾印。

null

nfsMountOptions

以逗號分隔的NFS掛載選項清單。

Kubernetes持續磁碟區的掛載選項通常會在儲存類別中指定、但如果儲存類別中未指定掛載選項、則Astra Trident會改回使用儲存後端組態檔中指定的掛載選項。

如果儲存類別或組態檔中未指定掛載選項、Astra Trident將不會在相關的持續磁碟區上設定任何掛載選項。

nasType

設定NFS或SMB磁碟區建立。

選項包括 nfs、 smb`或null。 *必須設定為 `smb 對於SMB Volume。*設定為null、預設為NFS Volume。

nfs

qtreesPerFlexvol

每FlexVol 個邊的最大qtree數、必須在範圍內[50、300]

200

smbShare

您可以指定下列其中一項：使用 Microsoft 管理主控台或 ONTAP CLI 建立的 SMB 共用名稱、或是允許 Astra Trident 建立 SMB 共用的名稱。

ONTAP 後端的 Amazon FSX 需要此參數。

smb-share

useREST

使用ONTAP Isrest API的布林參數。技術預覽

useREST 以*技術預覽*的形式提供、建議用於測試環境、而非用於正式作業工作負載。設定為時 true、Astra Trident將使用ONTAP 靜止API與後端進行通訊。

此功能需要ONTAP 使用更新版本的版本。此外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 Secret Manager 中的 FSX SVM 認證。
- name：機密的 Amazon 資源名稱（ ARN ）、其中包含 SVM 的認證。
- type：設為 awsarn。
請參閱 "建立 AWS Secrets Manager 密碼" 以取得更多資訊。

更新 `dataLIF` 初始組態之後

您可以在初始組態後變更資料LIF、方法是執行下列命令、以更新資料LIF提供新的後端Json檔案。

tridentctl update backend <backend-name> -f <path-to-backend-json-file-with-updated-dataLIF>

如果將PVCS附加至一或多個Pod、您必須關閉所有對應的Pod、然後將其重新啟動、新的資料LIF才會生效。

用於資源配置磁碟區的後端組態選項

您可以使用中的這些選項來控制預設資源配置 defaults 組態區段。如需範例、請參閱下列組態範例。

參數說明預設

參數	說明	預設
`spaceAllocation`	LUN的空間分配	`true`
`spaceReserve`	空間保留模式；「無」（精簡）或「Volume」（完整）	`none`
`snapshotPolicy`	要使用的Snapshot原則	`none`
`qosPolicy`	要指派給所建立磁碟區的QoS原則群組。選擇每個儲存集區或後端的其中一個qosPolicy或adaptiveQosPolicy。搭配Astra Trident使用QoS原則群組需要ONTAP 使用更新版本的版本。我們建議使用非共用的QoS原則群組、並確保原則群組會個別套用至每個組成群組。共享的QoS原則群組將強制所有工作負載的總處理量上限。	「」
`adaptiveQosPolicy`	要指派給所建立磁碟區的調適性QoS原則群組。選擇每個儲存集區或後端的其中一個qosPolicy或adaptiveQosPolicy。不受ONTAP-NAS-經濟支援。	「」
`snapshotReserve`	保留給快照「 0 」的磁碟區百分比	如果 `snapshotPolicy` 是 `none`、 `else` 「」
`splitOnClone`	建立複本時、從其父複本分割複本	`false`
`encryption`	在新磁碟區上啟用NetApp Volume Encryption（NVE）；預設為 `false`。必須在叢集上授權並啟用NVE、才能使用此選項。如果在後端啟用NAE、則Astra Trident中配置的任何磁碟區都會啟用NAE。如需詳細資訊、請參閱： "Astra Trident如何與NVE和NAE搭配運作"。	`false`
`luksEncryption`	啟用LUKS加密。請參閱 "使用Linux統一金鑰設定（LUKS）"。僅限 SAN 。	"
`tieringPolicy`	要使用的分層原則 `none`	`snapshot-only` 適用於 ONTAP 9.5 之前的 SVM-DR 組態
`unixPermissions`	新磁碟區的模式。如果是SMB磁碟區、請保留空白。	「」
`securityStyle`	新磁碟區的安全樣式。 NFS支援 `mixed` 和 `unix` 安全樣式： SMB 支援 `mixed` 和 `ntfs` 安全樣式：	NFS預設為 `unix`。 SMB 預設值為 `ntfs`。

spaceAllocation

LUN的空間分配

true

spaceReserve

空間保留模式；「無」（精簡）或「Volume」（完整）

none

snapshotPolicy

要使用的Snapshot原則

none

qosPolicy

要指派給所建立磁碟區的QoS原則群組。選擇每個儲存集區或後端的其中一個qosPolicy或adaptiveQosPolicy。

搭配Astra Trident使用QoS原則群組需要ONTAP 使用更新版本的版本。

我們建議使用非共用的QoS原則群組、並確保原則群組會個別套用至每個組成群組。共享的QoS原則群組將強制所有工作負載的總處理量上限。

「」

adaptiveQosPolicy

要指派給所建立磁碟區的調適性QoS原則群組。選擇每個儲存集區或後端的其中一個qosPolicy或adaptiveQosPolicy。

不受ONTAP-NAS-經濟支援。

「」

snapshotReserve

保留給快照「 0 」的磁碟區百分比

如果 snapshotPolicy 是 none、 else 「」

splitOnClone

建立複本時、從其父複本分割複本

false

encryption

在新磁碟區上啟用NetApp Volume Encryption（NVE）；預設為 false。必須在叢集上授權並啟用NVE、才能使用此選項。

如果在後端啟用NAE、則Astra Trident中配置的任何磁碟區都會啟用NAE。

如需詳細資訊、請參閱： "Astra Trident如何與NVE和NAE搭配運作"。

false

luksEncryption

啟用LUKS加密。請參閱 "使用Linux統一金鑰設定（LUKS）"。

僅限 SAN 。

tieringPolicy

要使用的分層原則 none

snapshot-only 適用於 ONTAP 9.5 之前的 SVM-DR 組態

unixPermissions

新磁碟區的模式。

如果是SMB磁碟區、請保留空白。

「」

securityStyle

新磁碟區的安全樣式。

NFS支援 mixed 和 unix 安全樣式：

SMB 支援 mixed 和 ntfs 安全樣式：

NFS預設為 unix。

SMB 預設值為 ntfs。

組態範例

SMB 磁碟區的儲存類別組態

使用 nasType、 node-stage-secret-name`和 `node-stage-secret-namespace、您可以指定SMB磁碟區、並提供所需的Active Directory認證資料。使用支援SMB磁碟區 ontap-nas 僅限驅動程式。

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: nas-smb-sc
provisioner: csi.trident.netapp.io
parameters:
  backendType: "ontap-nas"
  trident.netapp.io/nasType: "smb"
  csi.storage.k8s.io/node-stage-secret-name: "smbcreds"
  csi.storage.k8s.io/node-stage-secret-namespace: "default"

搭配加密管理程式的 AWS FSX for ONTAP 組態

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

FSX提供ONTAP 各種組態選項和範例

Creating your file...

後端組態選項

更新 dataLIF 初始組態之後

用於資源配置磁碟區的後端組態選項

組態範例

更新 `dataLIF` 初始組態之後