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

儲存組態選項

02/25/2026

PDF

查看適用於您的 Trident 組態的組態選項。

全域配置選項

這些組態選項適用於所有 Trident 組態、無論使用何種儲存平台。

選項說明範例

選項	說明	範例
`version`	設定檔版本號	`1`
`storageDriverName`	儲存驅動程式名稱	`ontap-nas`, `ontap-san`, `ontap-nas-economy`, `ontap-nas-flexgroup`, `solidfire-san`
`storagePrefix`	磁碟區名稱的選用前置字元。預設值： `netappdvp_`。	`staging_`
`limitVolumeSize`	對磁碟區大小的限制（可選）。預設值： "" （不強制執行）	`10g`

version

設定檔版本號

1

storageDriverName

儲存驅動程式名稱

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

storagePrefix

磁碟區名稱的選用前置字元。預設值： netappdvp_。

staging_

limitVolumeSize

對磁碟區大小的限制（可選）。預設值： "" （不強制執行）

10g

請勿將 storagePrefix（包括預設值）用於 Element 後端。預設情況下， `solidfire-san`驅動程式會忽略此設定，並且不使用前綴。NetApp 建議為 Docker 磁碟區對應使用特定的 tenantID，或使用屬性資料，該資料包含 Docker 版本、驅動程式資訊以及來自 Docker 的原始名稱（以防使用了任何名稱修改）。

系統提供了預設選項，避免您在建立每個磁碟區時都進行指定。此 `size`選項適用於所有控制器類型。有關如何設定預設磁碟區大小的範例，請參閱 ONTAP 設定部分。

選項說明範例

選項	說明	範例
`size`	新磁碟區的可選預設大小。預設值： `1G`	`10G`

size

新磁碟區的可選預設大小。預設值： 1G

10G

ONTAP 組態

除了上述全域配置值之外，使用 ONTAP 時，還可以使用下列頂級選項。

選項說明範例

選項	說明	範例
`managementLIF`	ONTAP 管理 LIF 的 IP 位址。您可以指定完整網域名稱（FQDN）。	`10.0.0.1`
`dataLIF`	協定 LIF 的 IP 位址。 ONTAP NAS 驅動程式：NetApp 建議指定 `dataLIF`。如果未提供，Trident 將從 SVM 取得 dataLIF。您可以指定一個完全限定網域名稱（FQDN）用於 NFS 掛載操作，從而建立輪詢 DNS 以在多個 dataLIF 之間進行負載平衡。 ONTAP SAN 驅動程式：請勿指定 iSCSI 或 FC。Trident 使用"ONTAP Selective LUN Map"來發現建立多路徑工作階段所需的 iSCSI 或 FC LIF。如果明確定義 `dataLIF`，則會產生警告。	`10.0.0.2`
`svm`	要使用的儲存虛擬機器（如果管理 LIF 是叢集 LIF ，則此項目為必填項）	`svm_nfs`
`username`	連接到儲存裝置的使用者名稱	`vsadmin`
`password`	連接儲存裝置的密碼	`secret`
`aggregate`	用於配置的 Aggregate （選用；如果設定，則必須指派給 SVM ）。對於 `ontap-nas-flexgroup` 驅動程式，此選項將被忽略。指派給 SVM 的所有 Aggregate 都將用於配置 FlexGroup Volume 。	`aggr1`
`limitAggregateUsage`	選用，如果使用率超過此百分比，則佈建失敗	`75%`
`nfsMountOptions`	對 NFS 掛載選項進行精細控制；預設值為 "-o nfsvers=3"。僅適用於 `ontap-nas`和 `ontap-nas-economy`驅動程式 "請在此處查看 NFS 主機組態資訊"。	`-o nfsvers=4`
`igroupName`	Trident 建立並管理每個節點 `igroups` 為 `netappdvp`。此值不能更改或省略。僅適用於 `ontap-san` driver。	`netappdvp`
`limitVolumeSize`	最大可請求磁碟區大小。	`300g`
`qtreesPerFlexvol`	每個 FlexVol 的最大 qtree 數量必須在 [50, 300] 範圍內，預設值為 200。對於 `ontap-nas-economy` 驅動程式，此選項允許自訂每個 FlexVol 的 qtree 數量上限。	`300`
`sanType`	僅支援 ontap-san`驅動程式。用於選擇 iSCSI 的 `iscsi、NVMe/TCP 的 nvme`或透過 Fibre Channel（FC）的 SCSI 的 `fcp。	`iscsi` 如果為空
`limitVolumePoolSize`	僅支援 `ontap-san-economy` 和 `ontap-san-economy` 驅動程式。限制 ONTAP ontap-nas-economy 和 ontap-san-economy 驅動程式中的 FlexVol 大小。	`300g`

managementLIF

ONTAP 管理 LIF 的 IP 位址。您可以指定完整網域名稱（FQDN）。

10.0.0.1

dataLIF

協定 LIF 的 IP 位址。

ONTAP NAS 驅動程式：NetApp 建議指定 dataLIF。如果未提供，Trident 將從 SVM 取得 dataLIF。您可以指定一個完全限定網域名稱（FQDN）用於 NFS 掛載操作，從而建立輪詢 DNS 以在多個 dataLIF 之間進行負載平衡。

ONTAP SAN 驅動程式：請勿指定 iSCSI 或 FC。Trident 使用"ONTAP Selective LUN Map"來發現建立多路徑工作階段所需的 iSCSI 或 FC LIF。如果明確定義 dataLIF，則會產生警告。

10.0.0.2

svm

要使用的儲存虛擬機器（如果管理 LIF 是叢集 LIF ，則此項目為必填項）

svm_nfs

username

連接到儲存裝置的使用者名稱

vsadmin

password

連接儲存裝置的密碼

secret

aggregate

用於配置的 Aggregate （選用；如果設定，則必須指派給 SVM ）。對於 ontap-nas-flexgroup 驅動程式，此選項將被忽略。指派給 SVM 的所有 Aggregate 都將用於配置 FlexGroup Volume 。

aggr1

limitAggregateUsage

選用，如果使用率超過此百分比，則佈建失敗

75%

nfsMountOptions

對 NFS 掛載選項進行精細控制；預設值為 "-o nfsvers=3"。僅適用於 `ontap-nas`和 `ontap-nas-economy`驅動程式 "請在此處查看 NFS 主機組態資訊"。

-o nfsvers=4

igroupName

Trident 建立並管理每個節點 igroups 為 netappdvp。

此值不能更改或省略。

僅適用於 ontap-san driver。

netappdvp

limitVolumeSize

最大可請求磁碟區大小。

300g

qtreesPerFlexvol

每個 FlexVol 的最大 qtree 數量必須在 [50, 300] 範圍內，預設值為 200。

對於 ontap-nas-economy 驅動程式，此選項允許自訂每個 FlexVol 的 qtree 數量上限。

300

sanType

*僅支援 ontap-san`驅動程式。*用於選擇 iSCSI 的 `iscsi、NVMe/TCP 的 nvme`或透過 Fibre Channel（FC）的 SCSI 的 `fcp。

iscsi 如果為空

limitVolumePoolSize

*僅支援 ontap-san-economy 和 ontap-san-economy 驅動程式。*限制 ONTAP ontap-nas-economy 和 ontap-san-economy 驅動程式中的 FlexVol 大小。

300g

系統提供了預設選項，避免在建立的每個 Volume 上都進行指定：

選項說明範例

選項	說明	範例
`spaceReserve`	空間預留模式； `none`（精簡配置）或 `volume`（厚配置）	`none`
`snapshotPolicy`	要使用的 Snapshot 原則、預設為 `none`	`none`
`snapshotReserve`	Snapshot 保留百分比，預設為 " 以接受 ONTAP 預設值	`10`
`splitOnClone`	建立時將複本與其父項分離，預設為 `false`	`false`
`encryption`	在新磁碟區上啟用 NetApp Volume Encryption (NVE)；預設為 `false`。若要使用此選項，必須在叢集上取得 NVE 授權並啟用 NVE。如果後端啟用了 NAE、則在 Trident 中配置的任何磁碟區都會啟用 NAE。如需更多資訊，請參閱："Trident 與 NVE 和 NAE 的運作方式"。	true
`unixPermissions`	已配置 NFS Volume 的 NAS 選項，預設為 `777`	`777`
`snapshotDir`	NAS 選項用於存取 `.snapshot` 目錄。	NFSv4 為 "true" ， NFSv3 為 "false"
`exportPolicy`	NFS 匯出策略要使用的 NAS 選項，預設值為 `default`	`default`
`securityStyle`	NAS 選項，用於存取已配置的 NFS Volume。 NFS 支援 mixed`和 `unix`安全樣式。預設值為 `unix。	`unix`
`fileSystemType`	SAN 選項用於選擇檔案系統類型，預設為 `ext4`	`xfs`
`tieringPolicy`	要使用的分層原則、預設為 `none`。	`none`
`skipRecoveryQueue`	刪除磁碟區時、繞過儲存設備中的還原佇列、並立即刪除磁碟區。	``

spaceReserve

空間預留模式； none（精簡配置）或 volume（厚配置）

none

snapshotPolicy

要使用的 Snapshot 原則、預設為 none

none

snapshotReserve

Snapshot 保留百分比，預設為 " 以接受 ONTAP 預設值

10

splitOnClone

建立時將複本與其父項分離，預設為 false

false

encryption

在新磁碟區上啟用 NetApp Volume Encryption (NVE)；預設為 false。若要使用此選項，必須在叢集上取得 NVE 授權並啟用 NVE。

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

如需更多資訊，請參閱："Trident 與 NVE 和 NAE 的運作方式"。

true

unixPermissions

已配置 NFS Volume 的 NAS 選項，預設為 777

777

snapshotDir

NAS 選項用於存取 .snapshot 目錄。

NFSv4 為 "true" ， NFSv3 為 "false"

exportPolicy

NFS 匯出策略要使用的 NAS 選項，預設值為 default

default

securityStyle

NAS 選項，用於存取已配置的 NFS Volume。

NFS 支援 mixed`和 `unix`安全樣式。預設值為 `unix。

unix

fileSystemType

SAN 選項用於選擇檔案系統類型，預設為 ext4

xfs

tieringPolicy

要使用的分層原則、預設為 none。

none

skipRecoveryQueue

刪除磁碟區時、繞過儲存設備中的還原佇列、並立即刪除磁碟區。

縮放選項

`ontap-nas`和 `ontap-san`驅動程式會為每個 Docker 磁碟區建立一個 ONTAP FlexVol。ONTAP 每個叢集節點最多支援 1000 個FlexVols，叢集最大支援 12,000 個FlexVol磁碟區。如果您的 Docker 磁碟區需求符合此限制，則 `ontap-nas`驅動程式是首選的 NAS 解決方案，因為FlexVols提供了額外的功能，例如 Docker 磁碟區粒度快照和複製。

如果您需要的 Docker 磁碟區數量超過了 FlexVol 限制所能容納的數量，請選擇 `ontap-nas-economy`或 `ontap-san-economy`驅動程式。

此 `ontap-nas-economy`驅動程式會在自動管理的 FlexVol 磁碟區集區中、以 ONTAP Qtree 的形式建立 Docker 磁碟區。Qtree 提供更高的擴充性、每個叢集節點最多可達 100,000 個、每個叢集最多可達 2,400,000 個、但會犧牲部分功能。此 `ontap-nas-economy`驅動程式不支援 Docker 磁碟區精細層級的快照或複製。

Docker Swarm 目前不支援 `ontap-nas-economy`驅動程式，因為 Docker Swarm 無法協調跨多個節點的磁碟區建立。

`ontap-san-economy`驅動程式會在自動管理的 FlexVol 磁碟區共用集區中、將 Docker 磁碟區建立為 ONTAP LUN。如此一來、每個 FlexVol 就不會僅限於一個 LUN、而且能為 SAN 工作負載提供更好的擴充性。視儲存陣列而定、ONTAP 每個叢集最多可支援 16384 個 LUN。由於磁碟區底層為 LUN、因此此驅動程式支援 Docker 磁碟區精細快照和複製。

選擇 `ontap-nas-flexgroup`驅動程式以提高單一磁碟區的平行處理能力，該磁碟區可擴充至 PB 級範圍，包含數十億個檔案。FlexGroups 的一些理想使用案例包括 AI/ML/DL、大數據和分析、軟體建置、串流、檔案儲存庫等。Trident 在配置 FlexGroup 磁碟區時會使用指派給 SVM 的所有 Aggregate。Trident 中的 FlexGroup 支援還需考慮以下幾點：

需要 ONTAP 版本 9.2 或更新版本。
截至撰寫本文時，FlexGroups 只支援 NFS v3。
建議為 SVM 啟用 64 位元 NFSv3 識別碼。
建議的最小 FlexGroup 成員 / 磁碟區大小為 100 GiB 。
FlexGroup 磁碟區不支援複製。

有關 FlexGroups 及適用於 FlexGroups 的工作負載的資訊，請參閱 "NetApp FlexGroup Volume 最佳實務做法與實作指南"。

若要在同一環境中獲得進階功能和大規模擴充，您可以執行多個 Docker Volume Plugin 執行個體，其中一個使用 ontap-nas，另一個使用 ontap-nas-economy。

Trident 的自訂 ONTAP 角色

您可以建立一個具有最低權限的 ONTAP 叢集角色，這樣您就不必使用 ONTAP 管理員角色在 Trident 中執行操作。當您在 Trident 後端組態中包含使用者名稱時，Trident 會使用您建立的 ONTAP 叢集角色來執行操作。

如需建立 Trident 自訂角色的詳細資訊，請參閱 "Trident 自訂角色產生器"。

使用 ONTAP CLI

使用以下命令建立新角色：

security login role create <role_name\> -cmddirname "command" -access all -vserver <svm_name\>
為 Trident 使用者建立使用者名稱：

security login create -username <user_name\> -application ontapi -authmethod password -role <name_of_role_in_step_1\> -vserver <svm_name\> -comment "user_description"
security login create -username <user_name\> -application http -authmethod password -role <name_of_role_in_step_1\> -vserver <svm_name\> -comment "user_description"
將角色對應至使用者：

security login modify username <user_name\> -vserver <svm_name\> -role <role_name\> -application ontapi -application console -authmethod <password\>

使用 System Manager

在 ONTAP System Manager 中執行下列步驟：

建立自訂角色 ：
1. 若要在叢集層級建立自訂角色，請選取 Cluster > Settings 。
  
  （或）若要在 SVM 層級建立自訂角色、請選取 Storage > Storage VMs > required SVM> Settings > Users and Roles。
2. 選擇 Users and Roles 旁邊的箭頭圖示（→）。
3. 在 Roles 下選擇 +Add。
4. 定義角色規則，然後點選 Save 。
將角色對應到 Trident 使用者： + 在 Users and Roles 頁面上執行下列步驟：
1. 在 Users 下方選擇 Add 圖示 +。
2. 選擇所需的使用者名稱，然後在 Role 下拉式選單中選擇角色。
3. 按一下 Save 。

如需更多資訊、請參閱下列頁面：

ONTAP 組態檔範例

<code>ontap-nas</code> 驅動程式的 NFS 範例

{
  "version": 1,
  "storageDriverName": "ontap-nas",
  "managementLIF": "10.0.0.1",
  "dataLIF": "10.0.0.2",
  "svm": "svm_nfs",
  "username": "vsadmin",
  "password": "password",
  "aggregate": "aggr1",
  "defaults": {
    "size": "10G",
    "spaceReserve": "none",
    "exportPolicy": "default"
  }
}

<code>ontap-nas-flexgroup</code> 驅動程式的 NFS 範例

{
  "version": 1,
  "storageDriverName": "ontap-nas-flexgroup",
  "managementLIF": "10.0.0.1",
  "dataLIF": "10.0.0.2",
  "svm": "svm_nfs",
  "username": "vsadmin",
  "password": "password",
  "defaults": {
    "size": "100G",
    "spaceReserve": "none",
    "exportPolicy": "default"
  }
}

<code>ontap-nas-economy</code> 驅動程式的 NFS 範例

{
  "version": 1,
  "storageDriverName": "ontap-nas-economy",
  "managementLIF": "10.0.0.1",
  "dataLIF": "10.0.0.2",
  "svm": "svm_nfs",
  "username": "vsadmin",
  "password": "password",
  "aggregate": "aggr1"
}

<code>ontap-san</code> 驅動程式的 iSCSI 範例

{
  "version": 1,
  "storageDriverName": "ontap-san",
  "managementLIF": "10.0.0.1",
  "dataLIF": "10.0.0.3",
  "svm": "svm_iscsi",
  "username": "vsadmin",
  "password": "password",
  "aggregate": "aggr1",
  "igroupName": "netappdvp"
}

<code>ontap-san-economy</code> 驅動程式的 NFS 範例

{
  "version": 1,
  "storageDriverName": "ontap-san-economy",
  "managementLIF": "10.0.0.1",
  "dataLIF": "10.0.0.3",
  "svm": "svm_iscsi_eco",
  "username": "vsadmin",
  "password": "password",
  "aggregate": "aggr1",
  "igroupName": "netappdvp"
}

<code>ontap-san</code> 驅動程式的 NVMe/TCP 範例

{
  "version": 1,
  "backendName": "NVMeBackend",
  "storageDriverName": "ontap-san",
  "managementLIF": "10.0.0.1",
  "svm": "svm_nvme",
  "username": "vsadmin",
  "password": "password",
  "sanType": "nvme",
  "useREST": true
}

<code>ontap-san</code> 驅動程式的 SCSI over FC 範例

{
  "version": 1,
  "backendName": "ontap-san-backend",
  "storageDriverName": "ontap-san",
  "managementLIF": "10.0.0.1",
  "sanType": "fcp",
  "svm": "trident_svm",
  "username": "vsadmin",
  "password": "password",
  "useREST": true
}

Element 軟體配置

除了全域設定值之外，在使用 Element 軟體（NetApp HCI/SolidFire）時，也可以使用這些選項。

選項說明範例

選項	說明	範例
`Endpoint`	https://<login>:<password>@<mvip>/json-rpc/<element-version>	https://admin:admin@192.168.160.3/json-rpc/8.0
`SVIP`	iSCSI IP 位址和連接埠	10.0.0.7:3260
`TenantName`	要使用的 SolidFire 租用戶（如果未找到則建立）	`docker`
`InitiatorIFace`	將 iSCSI 流量限制在非預設介面時、請指定介面	`default`
`Types`	QoS 規範	請參閱以下範例
`LegacyNamePrefix`	升級版 Trident 安裝的前綴。如果您使用的 Trident 是 1.3.2 之前的版本，並且使用現有磁碟區執行升級，則需要設定此值才能存取透過 volume-name 方法對應的舊磁碟區。	`netappdvp-`

Endpoint

https://<login>:<password>@<mvip>/json-rpc/<element-version>

https://admin:admin@192.168.160.3/json-rpc/8.0

SVIP

iSCSI IP 位址和連接埠

10.0.0.7:3260

TenantName

要使用的 SolidFire 租用戶（如果未找到則建立）

docker

InitiatorIFace

將 iSCSI 流量限制在非預設介面時、請指定介面

default

Types

QoS 規範

請參閱以下範例

LegacyNamePrefix

升級版 Trident 安裝的前綴。如果您使用的 Trident 是 1.3.2 之前的版本，並且使用現有磁碟區執行升級，則需要設定此值才能存取透過 volume-name 方法對應的舊磁碟區。

netappdvp-

該 solidfire-san 驅動程式不支援 Docker Swarm。

Element 軟體組態檔範例

{
  "version": 1,
  "storageDriverName": "solidfire-san",
  "Endpoint": "https://admin:admin@192.168.160.3/json-rpc/8.0",
  "SVIP": "10.0.0.7:3260",
  "TenantName": "docker",
  "InitiatorIFace": "default",
  "Types": [
    {
      "Type": "Bronze",
      "Qos": {
        "minIOPS": 1000,
        "maxIOPS": 2000,
        "burstIOPS": 4000
      }
    },
    {
      "Type": "Silver",
      "Qos": {
        "minIOPS": 4000,
        "maxIOPS": 6000,
        "burstIOPS": 8000
      }
    },
    {
      "Type": "Gold",
      "Qos": {
        "minIOPS": 6000,
        "maxIOPS": 8000,
        "burstIOPS": 10000
      }
    }
  ]
}

儲存組態選項

Creating your file...

全域配置選項

ONTAP 組態

縮放選項

Trident 的自訂 ONTAP 角色

ONTAP 組態檔範例

Element 軟體配置

Element 軟體組態檔範例