Configura Google Cloud NetApp Volumes
Puedes configurar Google Cloud NetApp Volumes como backend para que Trident aprovisione almacenamiento para cargas de trabajo de Kubernetes.
Descripción general
Trident es compatible con Google Cloud NetApp Volumes tanto para cargas de trabajo NAS (NFS y SMB) como en bloque (iSCSI).
-
Las cargas de trabajo NAS utilizan el
google-cloud-netapp-volumesbackend -
Las cargas de trabajo en bloque (iSCSI) utilizan el
google-cloud-netapp-volumes-sanbackend
Los volúmenes NAS proporcionan almacenamiento basado en archivos y se accede a ellos mediante protocolos NFS o SMB. Estos volúmenes admiten el acceso compartido a través de varios pods o nodos.
Los volúmenes en bloque proporcionan almacenamiento en bloque sin procesar y se accede a ellos como dispositivos iSCSI conectados a nodos Kubernetes. Estos volúmenes se utilizan cuando las aplicaciones requieren acceso a nivel de bloque.
Esto se aplica a los siguientes entornos:
-
Trident 26.02 y posteriores
-
Google Kubernetes Engine (GKE), o clústeres de Red Hat OpenShift que se ejecutan en GCP
-
OpenShift Workload Identity Federation (WIF) requiere Trident 26.10 o posterior
-
Pools de almacenamiento de Google Cloud NetApp Volumes
Para configurar el almacenamiento en bloque (iSCSI), consulta "Configura el almacenamiento en bloque (iSCSI)".
Prepárese para la configuración
La identidad en la nube permite que las cargas de trabajo de Kubernetes accedan a los recursos de Google Cloud autenticándose como una identidad de carga de trabajo en vez de usar credenciales estáticas.
Antes de configurar la identidad de la carga de trabajo, utiliza una cuenta autorizada para crear los recursos de identidad necesarios. En el caso de GKE, esto requiere permisos de Google Cloud para crear y configurar una cuenta de servicio de Google Cloud. En el caso de OpenShift, esto requiere permiso para crear o seleccionar la configuración WIF del clúster y para configurar el grupo de identidades de carga de trabajo de Google Cloud y el proveedor.
Usa la identidad de carga de trabajo de GKE
Para usar la identidad de carga de trabajo de GKE con Google Cloud NetApp Volumes, debes tener:
-
Un clúster de Kubernetes desplegado usando Google Kubernetes Engine (GKE)
-
Identidad de carga de trabajo habilitada en el clúster GKE y el servidor de metadatos habilitado en los grupos de nodos
-
Una cuenta de servicio de Google Cloud con la función de Google Cloud NetApp Volumes Admin (
roles/netapp.admin) o una función personalizada equivalente -
Trident instalado con el cloud provider establecido en
GCPy la cloud identity annotation configurada
Para instalar Trident utilizando el operador Trident, edita tridentorchestrator_cr.yaml:
apiVersion: trident.netapp.io/v1
kind: TridentOrchestrator
metadata:
name: trident
spec:
namespace: trident
cloudProvider: "GCP"
cloudIdentity: "iam.gke.io/gcp-service-account: cloudvolumes-admin-sa@mygcpproject.iam.gserviceaccount.com"
Establece el proveedor de la nube y la identidad de la nube al instalar Trident con Helm:
helm install trident trident-operator-100.6.0.tgz \ --set cloudProvider=GCP \ --set cloudIdentity="iam.gke.io/gcp-service-account: cloudvolumes-admin-sa@mygcpproject.iam.gserviceaccount.com"
Instala Trident especificando el proveedor de la nube y la identidad de la nube:
tridentctl install \ --cloud-provider=GCP \ --cloud-identity="iam.gke.io/gcp-service-account: cloudvolumes-admin-sa@mygcpproject.iam.gserviceaccount.com" \ -n trident
Utiliza la federación de identidades de cargas de trabajo en OpenShift
A partir de Trident 26.10, puedes usar Google Cloud Workload Identity Federation (WIF) para autenticar los controladores de Google Cloud NetApp Volumes en clústeres de OpenShift que se ejecutan en GCP. Esto se aplica a OpenShift Container Platform (OCP, incluidas las implementaciones IPI) autogestionado y a OpenShift Dedicated (OSD), y es compatible tanto con los controladores NAS (google-cloud-netapp-volumes) como con los SAN (google-cloud-netapp-volumes-san).
WIF canjea un token proyectado de cuenta de servicio de Kubernetes por credenciales de Google Cloud de corta duración. Trident usa esas credenciales para suplantar una cuenta de servicio de Google Cloud; los roles de IAM de esa cuenta de servicio autorizan sus llamadas a la API de Google Cloud NetApp Volumes. Así evitas almacenar una clave de cuenta de servicio de larga duración en la configuración del backend.
|
|
En OpenShift Dedicated, el proveedor de OIDC se puede compartir con otros componentes de OpenShift. Si la lista |
Preparar el clúster de OpenShift
Para OSD, crea o selecciona una configuración de GCP WIF al crear el clúster. Por ejemplo, OpenShift Cluster Manager CLI puede crear una:
ocm gcp create wif-config --name <wif-name> --project <gcp-project-id>
Selecciona Workload Identity Federation como el tipo de autenticación del clúster y asocia la configuración de WIF con el clúster. Para OCP autogestionado, configura un proveedor de OIDC de Google Cloud que confíe en el emisor de tokens de la cuenta de servicio del clúster. Los pasos de aprovisionamiento del clúster y proyección de tokens difieren entre OSD y OCP autogestionado; sigue las instrucciones de Red Hat correspondientes y pon el token proyectado a disposición del controlador de Trident en /var/run/secrets/wif-token/token.
La autenticación WIF de OSD se configura al crear el clúster. La audiencia WIF de Trident es un parámetro de instalación independiente; no necesitas volver a crear el clúster para habilitar WIF para Trident.
Antes de instalar o configurar Trident, comprueba que la identidad de OpenShift utilizada para la instalación cuente con los permisos de clúster que requiere el método de instalación elegido. Tras la instalación, comprueba que los pods del controlador y de los nodos estén en buen estado:
oc whoami
oc auth can-i create namespaces
oc auth can-i create csidrivers.storage.k8s.io
oc auth can-i create customresourcedefinitions.apiextensions.k8s.io
oc auth can-i create securitycontextconstraints.security.openshift.io
oc -n trident get pods
oc -n trident rollout status deploy/trident-controller --timeout=300s
oc -n trident rollout status ds/trident-node-linux --timeout=300s
Instala Trident con la audiencia de WIF
Trident solo genera el token para WIF cuando configuras la audiencia durante la instalación. Utiliza la misma audiencia tanto en el proveedor de Google Cloud como en la del backend wipCredentialConfig.audience:
//iam.googleapis.com/projects/<wif-pool-project-number>/locations/global/workloadIdentityPools/<pool-id>/providers/<provider-id>
Establece cloudProvider en GCP y configura gcpWIFAudience siguiendo el método de instalación que hayas seleccionado:
tridentctl install \
--cloud-provider GCP \
--gcp-wif-audience "<audience>" \
--namespace trident
Configura estos campos en la TridentOrchestrator spec:
spec:
cloudProvider: GCP
gcpWIFAudience: "<audience>"
Configura estos valores al instalar el chart:
helm install trident netapp-trident/trident-operator \
--set cloudProvider=GCP \
--set-string gcpWIFAudience="<audience>"
Tampoco configures la opción de GKE cloudIdentity / --cloud-identity para el WIF de OpenShift. No apliques parches al Deployment del controlador de Trident después de la instalación; el operador revierte los cambios manuales. El token proyectado está disponible para el backend en /var/run/secrets/wif-token/token. El trident-main contenedor no incluye un shell, así que revisa la configuración del volumen del Deployment del controlador en lugar de usar oc exec para comprobar el archivo:
oc -n trident get deploy trident-controller -o yaml
Configurar la confianza y los permisos de Google Cloud
Configura un Google Cloud Workload Identity Pool y un proveedor OIDC para el clúster. El emisor del proveedor debe coincidir con la claim del token iss, y su mapeo de atributos debe mapear assertion.sub a google.subject. La audiencia permitida del proveedor debe coincidir con la claim del token proyectado aud.
Los endpoints públicos .well-known/openid-configuration y JWKS solo son necesarios cuando usas el descubrimiento de OIDC. Google también admite subir el JWKS directamente usando jwksJson o --jwk-json-path.
Otorga al principal de WIF el roles/iam.workloadIdentityUser rol en la cuenta de servicio de Google Cloud que Trident va a suplantar. Para un sujeto de token de system:serviceaccount:trident:trident-controller, el principal tiene este formato:
principal://iam.googleapis.com/projects/<wif-pool-project-number>/locations/global/workloadIdentityPools/<pool-id>/subject/system:serviceaccount:trident:trident-controller
Otorga a la cuenta de servicio suplantada roles/netapp.admin en el proyecto que contiene los recursos de Google Cloud NetApp Volumes, o un rol personalizado equivalente con los permisos necesarios. Se trata de dos autorizaciones distintas: la primera permite la suplantación de identidad y la segunda autoriza las operaciones de la API de almacenamiento.
Si la audiencia del token y la configuración del proveedor no coinciden, Google Security Token Service puede rechazar el intercambio con un invalid_grant error de audiencia. Revisa la configuración del proveedor con:
gcloud iam workload-identity-pools providers describe <provider-id> \
--project=<wif-pool-project-id> \
--location=global \
--workload-identity-pool=<pool-id> \
--format="yaml(oidc.allowedAudiences,oidc.issuerUri,attributeMapping)"
Al diagnosticar la configuración de un token, compara las reclamaciones del token iss, aud y sub con la configuración del proveedor y de IAM. No compartas ni registres el token proyectado completo.
Prepara el almacenamiento de Google Cloud NetApp Volumes
Crea o identifica un pool de almacenamiento en la región utilizada por el backend. Los backends NAS requieren un pool FILE; los backends SAN utilizan los pools Flex Unified descritos en "Configura el almacenamiento en bloque (iSCSI)". Asegúrate de que la configuración de la VPC y del Private Service Access (PSA) del pool sea adecuada para la red del clúster.
Por ejemplo, enumera los rangos de emparejamiento globales de VPC existentes para una red antes de seleccionar el rango de PSA para un pool:
gcloud compute addresses list \
--project <gcnv-project-id> \
--global \
--filter="purpose=VPC_PEERING AND network:<network-name>" \
--format="table(name,address,prefixLength,status,network,purpose)"
Utiliza la región del grupo en location y, cuando sea necesario, selecciona el grupo de forma explícita usando su ruta completa del recurso en storagePools. Las discrepancias entre la región y la ubicación del grupo, una red incorrecta o un grupo no disponible pueden impedir la detección o el aprovisionamiento, incluso cuando la autenticación tenga éxito.
Configurar el backend de Trident
Utiliza la audiencia de tokens proyectada tanto en la configuración del proveedor como en wipCredentialConfig.audience. El campo projectNumber identifica el proyecto de Google Cloud NetApp Volumes; la audiencia utiliza el número de proyecto que contiene el Workload Identity Pool. Sustituye los marcadores de posición de este ejemplo por los valores de tu entorno:
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-nas-wif
namespace: trident
spec:
version: 1
storageDriverName: google-cloud-netapp-volumes
projectNumber: "<project-number>"
location: "<region>"
sdkTimeout: "600"
storage:
- labels:
cloud: gcp
network: "<vpc-network>"
serviceLevel: Premium
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
Para un backend SAN, utiliza google-cloud-netapp-volumes-san como storageDriverName y la configuración correspondiente del grupo Flex Unified. Por lo demás, la configuración de las credenciales WIF es la misma para ambos controladores.
Aplica el backend y comprueba su estado observado:
oc apply -f <backend-file>.yaml
oc -n trident get tridentbackendconfig <backend-name> -o yaml
Comprueba que el backend sea Bound y que su última operación se haya completado correctamente antes de probar el aprovisionamiento. Revisa las páginas en vivo spec y status; es posible que una anotación de configuración aplicada anteriormente no refleje los cambios posteriores. No incluyas credenciales estáticas apiKey si utilizas WIF.
Verifica el aprovisionamiento de extremo a extremo
Crea una StorageClass que apunte al backend y luego un PVC de prueba pequeño. Por ejemplo, una StorageClass NAS puede seleccionar una etiqueta de backend:
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: gcnv-wif-smoke
provisioner: csi.trident.netapp.io
parameters:
backendType: "google-cloud-netapp-volumes"
selector: "auth=wif"
allowVolumeExpansion: true
Añade la etiqueta correspondiente auth: wif a la entrada de almacenamiento del backend de NAS, crea un PVC con gcnv-wif-smoke y comprueba que llegue a Bound. Para una prueba básica de SAN, utiliza google-cloud-netapp-volumes-san, la configuración del controlador de SAN y un pool de Flex Unified adecuado. Elimina el PVC de prueba y StorageClass cuando termines.
Soluciona fallos comunes
| Síntoma | Qué hay que comprobar |
|---|---|
|
Compara la |
|
Comprueba que el principal WIF exacto del controlador Trident |
|
Comprueba que la cuenta de servicio suplantada tenga permisos de Google Cloud NetApp Volumes, como |
No se encontraron pools o no se encontró el pool |
Comprueba el backend |
El backend sigue sin estar vinculado |
Revisa los registros del controlador Trident y el estado de TridentBackendConfig para detectar cualquier error subyacente de autenticación, permisos o detección de pools. |
Para revisar los registros del controlador en busca de errores de reconciliación del backend:
oc -n trident logs deploy/trident-controller -c trident-main --tail=400
Configurar el almacenamiento NAS
|
|
Para los grupos de almacenamiento UNIFIED de Google Cloud NetApp Volumes, Trident aplica reglas de nomenclatura y validación específicas de UNIFIED durante las operaciones de volumen. |
Al localizar un volumen, Trident puede evaluar múltiples variantes de nombre de volumen compatibles (por ejemplo, formatos de guion y guion bajo) para mejorar la fiabilidad de la importación y el descubrimiento.
Detalles del controlador
Trident proporciona el google-cloud-netapp-volumes controlador para aprovisionar almacenamiento NAS desde Google Cloud NetApp Volumes.
El controlador admite los siguientes modos de acceso:
-
ReadWriteOnce (RWO)
-
ReadOnlyMany (ROX)
-
ReadWriteMany (RWX)
-
ReadWriteOncePod (RWOP)
| Controlador | Protocolo | VolumeMode | Modos de acceso compatibles | Sistemas de archivos compatibles |
|---|---|---|---|---|
|
NFS SMB |
Sistema de archivos |
RWO, ROX, RWX, RWOP |
|
Configura un backend NAS Trident
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-nas
namespace: trident
spec:
version: 1
storageDriverName: google-cloud-netapp-volumes
projectNumber: "<project-number>"
location: "<region>"
sdkTimeout: "600"
storage:
- labels:
cloud: gcp
network: "<vpc-network>"
Aprovisionar volúmenes NAS
Los volúmenes NAS se aprovisionan usando el google-cloud-netapp-volumes backend y son compatibles con los protocolos NFS y SMB.
StorageClass para volúmenes NFS
Para aprovisionar volúmenes NFS, establece nasType en nfs.
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: gcnv-nfs
provisioner: csi.trident.netapp.io
parameters:
backendType: "google-cloud-netapp-volumes"
trident.netapp.io/nasType: "nfs"
allowVolumeExpansion: true
StorageClass para volúmenes SMB
Para aprovisionar volúmenes SMB, establece nasType en smb y proporciona las credenciales.
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: gcnv-smb
provisioner: csi.trident.netapp.io
parameters:
backendType: "google-cloud-netapp-volumes"
trident.netapp.io/nasType: "smb"
csi.storage.k8s.io/node-stage-secret-name: "smbcreds"
csi.storage.k8s.io/node-stage-secret-namespace: "default"
allowVolumeExpansion: true
Ejemplo de PersistentVolumeClaim (RWX)
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: gcnv-nas-rwx
spec:
accessModes:
- ReadWriteMany
resources:
requests:
storage: 100Gi
storageClassName: gcnv-nfs
Ejemplo de PersistentVolumeClaim (RWO)
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: gcnv-nas-rwo
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 100Gi
storageClassName: gcnv-nfs
|
|
Los volúmenes NAS usan volumeMode: Filesystem.
|