Configura los grupos de almacenamiento en modo ONTAP de Google Cloud NetApp Volumes
A partir de Trident 26.06, puedes configurar los backends existentes ontap-san y ontap-nas para aprovisionar almacenamiento en los grupos de almacenamiento en modo ONTAP de Google Cloud NetApp Volumes (GCNV). Esta función es una Tech Preview.
|
|
Esta función es una Tech Preview en Trident 26.10. Las funciones en fase de Tech Preview no son compatibles para uso en producción. La funcionalidad, los campos de configuración y la matriz compatible pueden cambiar antes de la disponibilidad general (GA). |
Cómo funciona
Trident reutiliza la lógica existente de los controladores ontap-san y ontap-nas y redirige las llamadas REST de ONTAP a través de un endpoint proxy de GCNV. Este enfoque te permite aprovisionar y gestionar el almacenamiento en clústeres ONTAP alojados en GCNV mientras mantienes los mismos flujos de trabajo operativos que usas para un backend ONTAP directo. ONTAP-mode no introduce un nuevo controlador de almacenamiento. Lo habilitas por backend añadiendo un bloque de configuración gcnv a un backend ontap-san o ontap-nas.
La ruta de aprovisionamiento es la siguiente:
PersistentVolumeClaim → Trident (ontap-san o ontap-nas) → cliente REST de ONTAP → proxy GCNV → clúster de ONTAP en el pool GCNV
Ámbito compatible y no compatible
Esta versión preliminar (Tech Preview) admite lo siguiente:
-
Controladores:
ontap-san(iSCSI) yontap-nas(NFS o SMB). -
Operaciones del ciclo de vida a través del proxy: inicialización del backend, creación y eliminación de volúmenes y flujos REST de ONTAP relacionados.
-
Modelos de autenticación: Workload Identity Pool (WIP), clave de cuenta de servicio y Application Default Credentials (ADC) como recurso de reserva.
Lo siguiente queda fuera del alcance de esta versión preliminar técnica:
-
Los
ontap-san-economy,ontap-nas-economyyontap-nas-flexgroupcontroladores. -
La trayectoria de personalidad ASA r2.
-
Solución alternativa de ZAPI. El modo ONTAP usa solo ONTAP REST.
Requisitos previos
Antes de configurar un backend en modo ONTAP, asegúrate de que tienes lo siguiente:
-
Trident 26.06 o posterior.
-
Un grupo de almacenamiento GCNV en modo ONTAP en tu proyecto y ubicación de destino.
-
Permisos de GCP IAM para operaciones de proxy, adaptados adecuadamente a tu entorno.
-
Una configuración de backend que incluye
proxyURL,projectNumber,locationypoolID. -
Para los flujos de trabajo de SAN iSCSI, los requisitos previos de iSCSI y multivía del lado del nodo para tu plataforma. Consulta "Prepare el nodo de trabajo".
Configura el backend
Un TridentBackendConfig requiere credentials hacer referencia a un Kubernetes Secret. Para el modo ONTAP, el secreto proporciona credenciales para el acceso al proxy de GCP, no para ONTAP managementLIF / username / password. Según el método de autenticación, puede contener campos de clave de cuenta de servicio o estar vacío. svm es opcional: cada pool de GCNV en modo ONTAP tiene actualmente una SVM, y Trident la deriva del pool cuando se omite.
Para la autenticación mediante clave de cuenta de servicio, utiliza el mismo patrón que native GCNV: los campos no confidenciales en gcnv.apiKey, private_key y private_key_id en el secreto. Consulta "Ejemplos de configuración de Google Cloud NetApp Volumes". Para la autenticación mediante Workload Identity Pool o GKE cloud identity, consulta los ejemplos en Autenticación.
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-----
|
|
No incluyas |
Autenticación
Trident resuelve las credenciales para el acceso mediante proxy en el siguiente orden:
-
Grupo de identidades de carga de trabajo (WIP)
-
Clave de la cuenta de servicio
-
Credenciales predeterminadas de la aplicación (ADC)
Para esta Tech Preview, sigue estas recomendaciones:
-
Prefiere Workload Identity Pool siempre que esté disponible.
-
No incrustes claves privadas sin procesar en archivos de backend sujetos a control de versiones. Guarda las credenciales en un secreto de Kubernetes.
-
Aplica el alcance de IAM con privilegios mínimos a la cuenta de servicio.
El valor de location del bloque gcnv debe coincidir con la ubicación del grupo: utiliza la zona para un grupo zonal y la región para un grupo regional.
Grupo de identidades de cargas de trabajo
Utiliza gcnv.wipCredential para la federación explícita de cuentas externas configurada en TridentBackendConfig. En OpenShift, Trident proyecta el token en /var/run/secrets/wif-token/token; esta es la única ruta del token que Trident proyecta para OpenShift WIF, así que úsala para credential_source.file. Instala Trident con la audiencia de WIF, tal como se describe en "Configura Google Cloud NetApp Volumes con Workload Identity Federation". El campo credentials sigue haciendo referencia a un Secret, pero el Secret no debe contener un 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"
Identidad en la nube de GKE
Para GKE, configura la identidad en la nube de Trident durante la instalación tal como se describe en "Usa la identidad de carga de trabajo de GKE". El backend usa Application Default Credentials (ADC); omite tanto gcnv.apiKey como gcnv.wipCredential. El campo credentials sigue haciendo referencia a un Secret, pero no pongas private_key en él.
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>"
Comportamiento de validación e inicialización
Trident valida un backend en modo ONTAP durante la inicialización y falla rápidamente en lugar de inicializarse de forma parcial.
La inicialización del backend falla si falta algún campo obligatorio gcnv, si el controlador no es compatible con el modo ONTAP o si falla la resolución de credenciales.
Limitaciones conocidas
-
Esta función es una Tech Preview. El comportamiento y la matriz de compatibilidad pueden cambiar antes de GA.
-
La función de respaldo de ZAPI no se utiliza en modo ONTAP.
-
Los requisitos de protocolo y de preparación de los nodos siguen aplicándose. Por ejemplo, los flujos de trabajo de iSCSI requieren los requisitos previos del lado del nodo que se describen en "Prepare el nodo de trabajo".
-
Siguen siendo válidas las restricciones existentes del entorno ONTAP y GCNV.
Actualización y compatibilidad
ONTAP-mode es opcional para cada backend a través del gcnv bloque de configuración:
-
Los backends de ONTAP existentes que no son GCNV no se ven afectados.
-
Las implementaciones mixtas que combinan backends directos de ONTAP y backends proxy en modo ONTAP se admiten mediante la configuración a nivel de backend. Cada backend se configura de forma independiente.
-
Para dejar de usar ONTAP-mode, retira o sustituye los backends afectados. No hace falta ningún cambio global.
El futuro
Aplica secret antes de TBC; usa kubectl apply y -n trident para que coincidan con los ejemplos.