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 模式不会引入新的存储驱动程序。您可以通过向 ontap-san 或 ontap-nas 后端添加 gcnv 配置块来针对每个后端启用它。

配置路径如下所示:

PersistentVolumeClaim → Trident (ontap-san 或 ontap-nas) → ONTAP REST 客户端 → GCNV 代理 → GCNV 池中的 ONTAP 集群

支持和不支持的范围

此技术预览版支持以下功能:

  • 驱动程序: ontap-san (iSCSI) 和 ontap-nas (NFS 或 SMB)。

  • 通过代理的生命周期操作:后端初始化、卷创建和删除以及相关的 ONTAP REST 流。

  • 身份验证模型:Workload Identity Pool (WIP)、服务帐户密钥和 Application Default Credentials (ADC) 回退。

以下内容超出了此技术预览的范围:

  • ontap-san-economy、 `ontap-nas-economy`和 `ontap-nas-flexgroup`驱动程序。

  • ASA r2 personality 路径。

  • ZAPI 回退。ONTAP 模式仅使用 ONTAP REST。

前提条件

在配置 ONTAP 模式后端之前,请确保您已具备以下条件:

  • Trident 26.06 或更高版本。

  • 目标项目和位置中的 GCNV ONTAP 模式存储池。

  • 用于代理操作的 GCP IAM 权限,适用于您的环境。

  • 包含 proxyURL、 projectNumber、 `location`和 `poolID`的后端配置。

  • 对于 iSCSI SAN 工作流,您的平台的节点端 iSCSI 和多路径先决条件。请参阅 "准备工作节点"。

配置后端

`TridentBackendConfig` 需要  `credentials` 引用 Kubernetes Secret。对于 ONTAP 模式,secret 为 GCP 代理访问提供凭据,而不是 ONTAP `managementLIF` / `username` / `password`。根据身份验证方法,它可以包含服务帐户密钥字段或为空。 `svm` 是可选的:每个 GCNV ONTAP 模式池当前有一个 SVM,省略时 Trident 会从池中获取它。

对于服务帐户密钥身份验证,请使用与原生 GCNV 相同的模式:非敏感字段位于 `gcnv.apiKey`中, `private_key`和 `private_key_id`位于 secret 中。请参见 "Google Cloud NetApp Volumes 配置示例"。对于 Workload Identity Pool 或 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 spec 中——CRD 会拒绝它们。使用 ontap-san,并采用相同的 `gcnv`和凭据模式进行块存储。

身份验证

Trident 按以下顺序解析代理访问凭据:

  1. 工作负载身份池(WIP)

  2. 服务帐户密钥

  3. 应用程序默认凭据(ADC)

对于此技术预览,请使用以下做法:

  • 在可用时,首选 Workload Identity Pool。

  • 请勿在版本控制后端文件中嵌入原始私钥。将凭据存储在 Kubernetes 密钥中。

  • 将最小特权 IAM 作用域应用于服务帐户。

    `gcnv` 块中的  `location` 必须与池的位置匹配:区域池使用可用区,区域性池使用区域。

工作负载身份池

将 gcnv.wipCredential`用于在 `TridentBackendConfig`上配置的显式外部帐户联合。在 OpenShift 上,Trident 会将令牌投射到 `/var/run/secrets/wif-token/token;这是 Trident 为 OpenShift WIF 投射的唯一令牌路径,因此请将其用于 credential_source.file。按照"使用 Workload Identity Federation 配置 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,请在安装时配置 Trident 的云身份,如"使用 GKE 工作负载身份"中所述。后端使用应用程序默认凭据(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 之前发生变化。

  • ZAPI 回退未在 ONTAP 模式中使用。

  • 协议和节点就绪性要求仍然适用。例如,iSCSI 工作流需要 "准备工作节点" 中描述的节点端先决条件。

  • 现有的 ONTAP 和 GCNV 环境约束仍然适用。

升级和兼容性

ONTAP 模式可通过 gcnv 配置块在每个后端中选择启用:

  • 现有的非 GCNV ONTAP 后端不受影响。

  • 通过后端级配置支持将直接 ONTAP 后端和 ONTAP 模式代理后端相结合的混合部署。每个后端都是独立配置的。

  • 若要停止使用 ONTAP 模式,请删除或更换受影响的后端。无需全局切换。

下一步是什么?

在 TBC 之前应用 secret;使用 `kubectl apply`和 `-n trident`来匹配示例。