設定 Google Cloud NetApp Volumes ONTAP 模式儲存池
從 Trident 26.06 開始,您可以設定現有 `ontap-san`和 `ontap-nas`後端,以便在 Google Cloud NetApp Volumes (GCNV) ONTAP 模式儲存池上佈建儲存。此功能為技術預覽。
|
|
此功能在 Trident 26.10 中為技術預覽版。技術預覽功能不支援在生產環境中使用。在正式上市 (GA) 之前,其功能、組態欄位和支援的矩陣可能會有所變更。 |
工作原理
Trident 重複使用現有的 ontap-san 和 ontap-nas 驅動程式邏輯,並透過 GCNV 代理端點路由 ONTAP REST 呼叫。此方法可讓您在裝載於 GCNV 的 ONTAP 叢集上佈建和管理儲存設備,同時保持與直接 ONTAP 後端相同的作業工作流程。ONTAP 模式不會引入新的儲存驅動程式。您可以透過將 gcnv 組態區塊新增至 ontap-san 或 ontap-nas 後端,來針對每個後端啟用它。
配置路徑如下:
PersistentVolumeClaim → Trident (ontap-san 或 ontap-nas) → ONTAP REST 用戶端 → GCNV 代理程式 → GCNV 集區中的 ONTAP 叢集
受支援和不受支援的範圍
此技術預覽版支援以下功能:
-
驅動程式:
ontap-san(iSCSI)和ontap-nas(NFS 或 SMB)。 -
透過代理執行生命週期操作:後端初始化、磁碟區建立和刪除以及相關的 ONTAP REST 流程。
-
驗證模型:工作負載身分集區 (WIP)、服務帳戶金鑰和應用程式預設憑證 (ADC) 備援。
以下內容不在本次技術預覽的範圍內:
-
ontap-san-economy、ontap-nas-economy以及ontap-nas-flexgroup驅動程式。 -
ASA r2 特性路徑。
-
ZAPI 回退。ONTAP 模式僅使用 ONTAP REST。
先決條件
在設定 ONTAP 模式後端之前,請確保您已具備以下條件:
-
Trident 26.06 或更高版本。
-
在目標專案和位置中有一個 GCNV ONTAP 模式儲存池。
-
GCP IAM 代理程式操作權限,並已根據您的環境進行適當範圍設定。
-
後端配置包括
proxyURL、projectNumber、location`和 `poolID。 -
有關 iSCSI SAN 工作流程,請參閱平台所需的節點端 iSCSI 和多路徑先決條件。請參閱 "準備工作節點"。
配置後端
A TridentBackendConfig 需要 credentials 參照 Kubernetes Secret。對於 ONTAP 模式,此 Secret 提供 GCP Proxy 存取的認證資料,而非 ONTAP managementLIF / username / password。根據身分驗證方法的不同,它可以包含服務帳戶金鑰欄位,也可以是空白。 svm 是選用的:每個 GCNV ONTAP 模式資源池目前都有一個 SVM,如果省略,Trident 會從資源池衍生出該 SVM。
對於服務帳戶金鑰驗證,請使用與原生 GCNV 相同的模式:非敏感欄位位於 `gcnv.apiKey`中, `private_key`和 `private_key_id`位於 secret 中。請參閱 "Google Cloud NetApp Volumes 設定範例"。對於工作負載身分資源池或 GKE 雲端身分驗證,請參閱 驗證 中的範例。
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-san
namespace: trident
spec:
version: 1
storageDriverName: ontap-san
backendName: gcnv-ontap-san
credentials:
name: gcnv-sa-secret
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
svm: "<svm-name>"
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-nas
namespace: trident
spec:
version: 1
storageDriverName: ontap-nas
backendName: gcnv-ontap-nas
credentials:
name: gcnv-sa-secret
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
apiKey:
type: service_account
project_id: "<project-id>"
client_email: "<service-account-email>"
client_id: "<client-id>"
auth_uri: "https://accounts.google.com/o/oauth2/auth"
token_uri: "https://oauth2.googleapis.com/token"
auth_provider_x509_cert_url: "https://www.googleapis.com/oauth2/v1/certs"
client_x509_cert_url: "<client-x509-cert-url>"
svm: "<svm-name>"
apiVersion: v1
kind: Secret
metadata:
name: gcnv-sa-secret
namespace: trident
type: Opaque
stringData:
private_key_id: "<private-key-id>"
private_key: |
-----BEGIN PRIVATE KEY-----
<private-key>
-----END PRIVATE KEY-----
|
|
請勿將 `private_key`或 `private_key_id`放入 `TridentBackendConfig`規格中——CRD 會拒絕它們。對於區塊儲存,請使用 `ontap-san`搭配相同的 `gcnv`和憑證模式。 |
驗證
Trident 會依照下列順序解析 Proxy 存取認證資料:
-
工作負載身分資源池(WIP)
-
服務帳戶金鑰
-
應用程式預設認證資料(ADC)
對於本次技術預覽,請遵循以下做法:
-
優先選擇工作負載身分資源池(如果可用)。
-
不要將原始私鑰嵌入到版本控制的後端檔案中。將認證資料儲存在 Kubernetes Secret 中。
-
對服務帳戶套用最小權限 IAM 範圍。
`location`中的 `gcnv`區塊必須與資源池的位置相符:區域性資源池使用 zone,地區性資源池使用 region。
工作負載身分資源池
將 gcnv.wipCredential 用於在 TridentBackendConfig 上設定的明確外部帳戶聯盟。在 OpenShift 上,Trident 會將權杖投射到 /var/run/secrets/wif-token/token;這是 Trident 為 OpenShift WIF 投射的唯一權杖路徑,因此請將其用於 credential_source.file。如 "設定 Google Cloud NetApp Volumes 與工作負載身分聯盟" 所述,使用 WIF 對象安裝 Trident。 credentials 欄位仍參照 Secret,但 Secret 不得包含 private_key。
apiVersion: v1
kind: Secret
metadata:
name: gcnv-ontap-empty
namespace: trident
type: Opaque
---
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-nas-wip
namespace: trident
spec:
version: 1
storageDriverName: ontap-nas
backendName: gcnv-ontap-nas-wip
useREST: true
nasType: nfs
nfsMountOptions: nfsvers=4.1
credentials:
name: gcnv-ontap-empty
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
wipCredential:
type: external_account
audience: "//iam.googleapis.com/projects/<wif-pool-project-number>/locations/global/workloadIdentityPools/<wif-pool-id>/providers/<provider-id>"
subject_token_type: "urn:ietf:params:oauth:token-type:jwt"
token_url: "https://sts.googleapis.com/v1/token"
service_account_impersonation_url: "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/<service-account-email>:generateAccessToken"
credential_source:
file: "/var/run/secrets/wif-token/token"
GKE 雲端身分
對於 GKE,請在安裝時依照 "使用 GKE 工作負載身分" 中的說明設定 Trident 的雲端身分。後端使用應用程式預設認證資料(ADC);請省略 gcnv.apiKey`和 `gcnv.wipCredential。 credentials 欄位仍然參照 Secret,但請勿在其中放置 private_key。
apiVersion: v1
kind: Secret
metadata:
name: gcnv-ontap-empty
namespace: trident
type: Opaque
---
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-nas-wi
namespace: trident
spec:
version: 1
storageDriverName: ontap-nas
backendName: gcnv-ontap-nas-wi
useREST: true
nasType: nfs
nfsMountOptions: nfsvers=4.1
credentials:
name: gcnv-ontap-empty
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
驗證和初始化行為
Trident 在初始化期間驗證 ONTAP 模式後端,並快速失敗而不是部分初始化。
如果缺少必要 `gcnv`欄位、驅動程式不支援 ONTAP 模式或認證資料解析失敗,則後端初始化失敗。
已知限制
-
此功能目前處於技術預覽階段。在 GA 前,其行為和支援的對照表可能會有所更改。
-
ONTAP 模式下不使用 ZAPI 回退機制。
-
協定和節點就緒要求仍然適用。例如,iSCSI 工作流程需要 "準備工作節點" 中所述的節點端先決條件。
-
現有的 ONTAP 和 GCNV 環境限制仍然適用。
升級和相容性
ONTAP 模式可透過 `gcnv`組態區塊按後端選擇啟用:
-
現有的非 GCNV ONTAP 後端不受影響。
-
透過後端層級的組態,支援結合直接 ONTAP 後端和 ONTAP 模式 Proxy 後端的混合部署。每個後端都是獨立設定的。
-
若要停止使用 ONTAP 模式,請移除或取代受影響的後端。不需要全域交換器。
接下來呢?
在 TBC 之前套用機密;使用 kubectl apply 和 -n trident 來符合範例。