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

設定 Google Cloud NetApp Volumes ONTAP 模式儲存池

貢獻者 joan-ing

從 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 雲端身分驗證,請參閱 驗證 中的範例。

ontap-san 後端
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>"
ontap-nas 後端
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 存取認證資料:

  1. 工作負載身分資源池(WIP)

  2. 服務帳戶金鑰

  3. 應用程式預設認證資料(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 來符合範例。