配置 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 模式不会引入新的存储驱动程序。您可以通过向 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 云身份验证,请参见 身份验证 中的示例。
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-----
|
|
请勿将 |
身份验证
Trident 按以下顺序解析代理访问凭据:
-
工作负载身份池(WIP)
-
服务帐户密钥
-
应用程序默认凭据(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`来匹配示例。