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 Google Cloud NetApp Volumes para cargas de trabajo SAN

Colaboradores joan-ing

Utiliza el controlador google-cloud-netapp-volumes-san para aprovisionar volúmenes de bloques iSCSI desde los grupos de almacenamiento Flex Unified de Google Cloud NetApp Volumes.

Nota El controlador SAN solo admite cargas de trabajo en bloque. Para aprovisionar volúmenes NAS, utiliza el controlador google-cloud-netapp-volumes.

Descripción general

El controlador aprovisiona volúmenes desde pools de almacenamiento de Flex Unified y los presenta a los nodos de Kubernetes como dispositivos de bloque iSCSI.

El controlador es compatible con los siguientes entornos:

  • Trident 26.02 y posteriores

  • Google Kubernetes Engine (GKE), o clústeres de Red Hat OpenShift que se ejecutan en GCP

  • Pools de almacenamiento unificado de Google Cloud NetApp Volumes Flex

  • cargas de trabajo basadas en iSCSI

A partir de Trident 26.10, el controlador SAN admite Google Cloud Workload Identity Federation (WIF) en clústeres autogestionados de OpenShift Container Platform (OCP, incluidas las implementaciones IPI) y OpenShift Dedicated (OSD) que se ejecutan en GCP. Para conocer los requisitos previos de WIF y la configuración del backend, consulta "Utiliza la federación de identidades de cargas de trabajo en OpenShift". Usa el nombre del controlador SAN y la configuración de almacenamiento Flex Unified de esta página.

Configurar WIF para SAN

WIF canjea un token proyectado de cuenta de servicio de Kubernetes por credenciales de Google Cloud de corta duración. Trident utiliza estas credenciales para suplantar una cuenta de servicio de Google Cloud cuando llama a la API de Google Cloud NetApp Volumes.

Configura un Google Cloud Workload Identity Pool y un proveedor OIDC para el clúster de OpenShift. El emisor del proveedor debe coincidir con la claim del token iss, y su mapeo de atributos debe mapear assertion.sub a google.subject.

Instala Trident indicando como nombre de recurso del proveedor la audiencia de WIF. Esto hace que Trident proyecte el token de la cuenta de servicio del controlador en /var/run/secrets/wif-token/token.

Operador de Trident
apiVersion: trident.netapp.io/v1
kind: TridentOrchestrator
metadata:
  name: trident
spec:
  namespace: trident
  cloudProvider: GCP
  gcpWIFAudience: "//iam.googleapis.com/projects/<wif-pool-project-number>/locations/global/workloadIdentityPools/<pool-id>/providers/<provider-id>"
Timón
helm install trident <trident-operator-package> \
  --namespace trident \
  --create-namespace \
  --set cloudProvider=GCP \
  --set-string gcpWIFAudience="//iam.googleapis.com/projects/<wif-pool-project-number>/locations/global/workloadIdentityPools/<pool-id>/providers/<provider-id>"
tridentctl
tridentctl install \
  --namespace trident \
  --cloud-provider GCP \
  --gcp-wif-audience "//iam.googleapis.com/projects/<wif-pool-project-number>/locations/global/workloadIdentityPools/<pool-id>/providers/<provider-id>"

Utiliza la misma audiencia para la instalación de Trident y wipCredentialConfig.audience. No configures tampoco GKE cloudIdentity ni --cloud-identity. No apliques parches al Deployment del controlador para añadir el token proyectado; el operador de Trident puede sobrescribir ese cambio.

Importante

En OpenShift Dedicated, el proveedor de OIDC se puede compartir con otros componentes de OpenShift. Si la lista allowedAudiences del proveedor está vacía, Google acepta el nombre de recurso canónico del proveedor, con o sin el prefijo https://, así que no hace falta cambiar el proveedor para la audiencia anterior. No establezcas una lista de audiencias explícita solo para Trident. Si el proveedor ya tiene audiencias explícitas, añade la audiencia de Trident y conserva todos los valores existentes. Sustituir la lista puede impedir que otros componentes de OpenShift intercambien tokens.

Otorga a la entidad principal de WIF de la cuenta de servicio del controlador de Trident el roles/iam.workloadIdentityUser rol en la cuenta de servicio de Google Cloud que Trident suplantará. Para la cuenta de servicio predeterminada del controlador de Trident, el asunto del token es system:serviceaccount:trident:trident-controller; usa el asunto configurado para tu instalación. Otorga a la cuenta de servicio suplantada roles/netapp.admin, o permisos equivalentes, en el proyecto que contiene los recursos de Google Cloud NetApp Volumes.

Añade el siguiente bloque al spec del backend SAN:

wipCredentialConfig:
  type: external_account
  audience: "//iam.googleapis.com/projects/<wif-pool-project-number>/locations/global/workloadIdentityPools/<pool-id>/providers/<provider-id>"
  subject_token_type: urn:ietf:params:oauth:token-type:jwt
  token_url: https://sts.googleapis.com/v1/token
  credential_source:
    file: /var/run/secrets/wif-token/token
  service_account_impersonation_url: https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/<service-account-email>:generateAccessToken

La configuración de WIF es la misma para ambos controladores GCNV. El backend SAN debe seguir utilizando google-cloud-netapp-volumes-san y un pool de almacenamiento Flex Unified compatible.

Pools de almacenamiento unificado Flex

Los grupos de almacenamiento de Flex Unified proporcionan almacenamiento en bloque mediante el protocolo iSCSI y son necesarios para el aprovisionamiento de SAN:

  • Se admiten los pools REGIONALES de Flex Unified.

  • Las agrupaciones de Flex Unified ZONAL son compatibles a partir de Trident 26.02.1.

  • Solo se admite el nivel de servicio Flex para cargas de trabajo SAN.

El backend location debe coincidir con la región del pool Flex Unified. Si Trident no encuentra el pool, comprueba la región, la red y la ruta del recurso del pool.

Configura un backend Trident SAN

apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
  name: gcnv-san
  namespace: trident
spec:
  version: 1
  storageDriverName: google-cloud-netapp-volumes-san
  projectNumber: "<project-number>"
  location: "<region>"
  sdkTimeout: "600"
  storage:
  - labels:
      cloud: gcp
      performance: flex
    network: "<vpc-network>"
    serviceLevel: Flex

Crea un StorageClass

Después de configurar el backend SAN, crea un StorageClass que haga referencia al google-cloud-netapp-volumes-san driver.

Especifica el tipo de sistema de archivos en StorageClass, no en el backend.

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: gcnv-san
provisioner: csi.trident.netapp.io
parameters:
  backendType: "google-cloud-netapp-volumes-san"
  fsType: "ext4"
allowVolumeExpansion: true

El controlador es compatible con los siguientes tipos de sistemas de archivos:

  • ext4 (predeterminado)

  • ext3

  • xfs

Nota El controlador SAN solo es compatible con el nivel de servicio Flex y no utiliza parámetros de backend específicos de NAS como exportRule, unixPermissions, nasType, snapshotDir, nfsMountOptions o configuraciones relacionadas con el tiering.

Verifica el aprovisionamiento de WIF

Aplica el backend y comprueba que TridentBackendConfig esté vinculado y que su última operación se haya realizado correctamente:

oc apply -f <backend-file>.yaml
oc -n trident get tridentbackendconfig <backend-name> -o yaml

Crea un PVC con gcnv-san`StorageClass de esta página y comprueba que llega a `Bound. Esto valida conjuntamente el intercambio de WIF, la suplantación de identidad de la cuenta de servicio, los permisos de Google Cloud NetApp Volumes y la selección del pool SAN. Elimina el PVC de prueba cuando termines.

Si falla la conciliación del backend, revisa los registros del controlador Trident:

oc -n trident logs deploy/trident-controller -c trident-main --tail=400

Comprueba los siguientes puntos para detectar errores habituales:

  • Si hay un error de audiencia invalid_grant, compara el claim del token aud con las audiencias permitidas del proveedor OIDC y wipCredentialConfig.audience.

  • Si se produce un error de permiso iam.serviceAccounts.getAccessToken, comprueba que el principal WIF del controlador Trident tenga roles/iam.workloadIdentityUser en la cuenta de servicio suplantada.

  • Para un netapp.storagePools.list error de permisos, comprueba que la cuenta de servicio suplantada tenga los permisos necesarios de Google Cloud NetApp Volumes en el proyecto correcto.

  • Si no se encuentra el grupo, comprueba que su ubicación y tipo sean compatibles, que la región del backend coincida con la del grupo y que el backend haga referencia a la red y al grupo correctos.

Provisiona volúmenes en bloque

ReadWriteOnce (RWO)

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: gcnv-san-rwo
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 100Gi
  storageClassName: gcnv-san

ReadWriteOncePod (RWOP)

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: gcnv-san-rwop
spec:
  accessModes:
    - ReadWriteOncePod
  resources:
    requests:
      storage: 100Gi
  storageClassName: gcnv-san

ReadOnlyMany (ROX)

Un patrón común para ROX es clonar un volumen ReadWriteOnce existente y montar el clon como de solo lectura.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: gcnv-san-rox
spec:
  accessModes:
    - ReadOnlyMany
  resources:
    requests:
      storage: 100Gi
  storageClassName: gcnv-san
  dataSource:
    kind: PersistentVolumeClaim
    name: gcnv-san-rwo

ReadWriteMany (RWX) — solo bloque en bruto

ReadWriteMany solo se admite cuando volumeMode: Block.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: gcnv-san-raw-rwx
spec:
  accessModes:
    - ReadWriteMany
  volumeMode: Block
  resources:
    requests:
      storage: 100Gi
  storageClassName: gcnv-san

Comportamiento del volumen de bloques

Los volúmenes de bloques se aprovisionan como LUN iSCSI y se presentan a los nodos de Kubernetes como dispositivos de bloque.

Volúmenes en bloque:

  • Usa el protocolo iSCSI

  • Soporte para sistema de archivos y presentación de bloques sin procesar

  • Están adjuntos y gestionados por Trident

  • Soporta múltiples modos de acceso a Kubernetes

Modos de acceso

Los volúmenes en bloque aprovisionados por Trident admiten los siguientes modos de acceso:

  • ReadWriteOnce (RWO)

  • ReadOnlyMany (ROX)

  • ReadWriteOncePod (RWOP)

  • ReadWriteMany (RWX), compatible solo cuando volumeMode: Block

volumeMode comportamiento

El volumeMode campo controla cómo se expone un volumen de bloque:

  • Filesystem Trident formatea y monta el volumen.

  • Block Trident conecta el dispositivo y lo expone como un dispositivo de bloque sin procesar.

Operaciones compatibles

Los volúmenes en bloque aprovisionados usando el controlador google-cloud-netapp-volumes-san admiten:

  • Crear

  • Borrar

  • Clonar

  • Snapshot

  • Cambie el tamaño

  • Importar

Sobrecarga de tamaño del volumen

Los volúmenes de bloque de Google Cloud NetApp Volumes incluyen una sobrecarga de metadatos internos. Como resultado, el tamaño del dispositivo visible para el kernel es menor que la capacidad aprovisionada.

Sobrecarga observada:

  • Aproximadamente 300 KiB cuando se crea un volumen

  • Hasta aproximadamente 107 MiB tras un cambio de tamaño

Google Cloud NetApp Volumes admite asignaciones de capacidad en GiB enteros. Para garantizar que el tamaño utilizable del dispositivo sea igual o superior a la solicitud del PVC, Trident:

  • Redondea el tamaño solicitado al siguiente GiB entero.

  • Añade un búfer de 1 GiB.

Por ejemplo:

  • Solicitud de PVC: 100 GiB.

  • Capacidad aprovisionada: 101 GiB.

  • Capacidad utilizable visible para la aplicación: al menos 100 GiB.

Ejemplos de pods

Volumen de bloque montado en el sistema de archivos (RWO)

apiVersion: v1
kind: Pod
metadata:
  name: app-rwo
spec:
  containers:
  - name: app
    image: ubuntu:22.04
    command: ["sleep", "infinity"]
    volumeMounts:
    - name: data
      mountPath: /mnt/data
  volumes:
  - name: data
    persistentVolumeClaim:
      claimName: gcnv-san-rwo

Dispositivo de bloque raw (RWX)

apiVersion: v1
kind: Pod
metadata:
  name: app-raw-rwx
spec:
  containers:
  - name: app
    image: ubuntu:22.04
    command: ["sleep", "infinity"]
    volumeDevices:
    - name: data
      devicePath: /dev/xda
  volumes:
  - name: data
    persistentVolumeClaim:
      claimName: gcnv-san-raw-rwx

Comportamiento de attach y mount

Para volúmenes SAN aprovisionados desde Google Cloud NetApp Volumes:

  • Trident crea un Logical Unit Number (LUN) en un grupo de almacenamiento Flex Unified.

  • Durante la publicación, Trident asigna el LUN a un grupo de hosts por nodo.

  • Durante la puesta en escena del nodo, Trident:

    • Inicia sesión en el target iSCSI

    • Descubre el LUN

    • Configura multivía

  • Si volumeMode: Filesystem, Trident formatea el dispositivo si es necesario y lo monta.

  • Si volumeMode: Block, Trident conecta el dispositivo y lo expone directamente al pod sin formatear ni montar.

Nota Los volúmenes de bloques SAN no proporcionan bloqueo distribuido ni coordinación de escritura. Cuando un volumen de bloques es accedido por varios nodos (ReadWriteMany con volumeMode: Block), la aplicación o el sistema de archivos debe gestionar la concurrencia.