Skip to main content
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Configura los grupos de almacenamiento en modo ONTAP de Google Cloud NetApp Volumes

Colaboradores joan-ing

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.

Nota

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) y ontap-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-economy y ontap-nas-flexgroup controladores.

  • 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, location y poolID.

  • 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.

backend de 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>"
backend de 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>"
Secreto
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-----
Nota

No incluyas private_key ni private_key_id en la TridentBackendConfig spec; el CRD los rechaza. Utiliza ontap-san con el mismo gcnv y patrón de credenciales para el almacenamiento en bloque.

Autenticación

Trident resuelve las credenciales para el acceso mediante proxy en el siguiente orden:

  1. Grupo de identidades de carga de trabajo (WIP)

  2. Clave de la cuenta de servicio

  3. 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.