Configura Google Cloud NetApp Volumes para cargas de trabajo SAN
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.
|
|
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.
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>"
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 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.
|
|
En OpenShift Dedicated, el proveedor de OIDC se puede compartir con otros componentes de OpenShift. Si la lista |
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
|
|
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 tokenaudcon las audiencias permitidas del proveedor OIDC ywipCredentialConfig.audience. -
Si se produce un error de permiso
iam.serviceAccounts.getAccessToken, comprueba que el principal WIF del controlador Trident tengaroles/iam.workloadIdentityUseren la cuenta de servicio suplantada. -
Para un
netapp.storagePools.listerror 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 cuandovolumeMode: Block
volumeMode comportamiento
El volumeMode campo controla cómo se expone un volumen de bloque:
-
FilesystemTrident formatea y monta el volumen. -
BlockTrident 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.
|
|
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.
|