Habilitación del redondeo automático de la capacidad para perfiles de IOPS fijos

Con la función de redondeo de capacidad del controlador CSI de archivos VPC de IBM, puede permitir que el controlador ajuste automáticamente la capacidad solicitada de una reclamación de volumen persistente (PVC) cuando sea inferior a la capacidad mínima admitida para el perfil de IOPS fijo seleccionado. Esto elimina la necesidad de calcular manualmente los valores de capacidad mínima antes de aprovisionar recursos compartidos de archivos.

Cómo funciona el redondeo de la capacidad

Durante la iniciación del controlador, el controlador VPC File CSI de IBM recupera un catálogo de capacidad a IOPS compatible del Catálogo Global de IBM. El catálogo se almacena en caché en la memoria y se utiliza para todas las solicitudes de aprovisionamiento posteriores. La siguiente tabla describe el comportamiento del controlador durante el aprovisionamiento de PVC.

Comportamiento del redondeo de capacidad en el aprovisionamiento
Escenario Driver Behavior
Se admite el número de IOPS solicitado y la capacidad solicitada está por debajo del mínimo El controlador redondea la capacidad al valor mínimo admitido y aprovisiona el PVC.
Se admite el número de IOPS solicitado y la capacidad solicitada cumple con los requisitos mínimos El PVC proporciona la capacidad solicitada.
No se admite el número de IOPS solicitado El aprovisionamiento falla debido a un error de validación. Para obtener ayuda sobre cómo resolver este error, consulta Solución de problemas relacionados con el redondeo de la capacidad.

Si no se puede acceder a Global Catalog al iniciar el controlador, se registra una advertencia y la redondeo de capacidad no está disponible. El resto del comportamiento del aprovisionamiento continúa según lo previsto.

Requisitos previos

Antes de habilitar el redondeo de capacidad, el controlador debe poder acceder a un Catálogo Glob IBM. Para permitir el acceso, configura una puerta de enlace de punto final privado virtual (VPEG) en tu VPC.

  1. Crea una puerta de enlace de punto final privado virtual en tu VPC para el servicio Catálogo de recursos globales.

    Al crear el VPEG, configura los siguientes parámetros:

    • En Servicios en la nube, selecciona Catálogo global de recursos.
    • En Puntos de conexión disponibles, selecciona el punto de conexión con el tipo de punto de conexión api y URL o private.globalcatalog.cloud.ibm.com *.private.globalcatalog.cloud.ibm.com.

    Utilice los nombres exactos de los servicios y las URL tal y como aparecen en la interfaz de usuario de IBM Cloud.

  2. Comprueba que los nodos de tu clúster puedan acceder al punto final privado del Catálogo Global. Sin conexión, el controlador registra una advertencia al iniciarse y la redondeo de capacidad no está disponible. El resto del comportamiento del aprovisionamiento continúa según lo previsto.

Crear un StorageClass con el redondeo de capacidad activado

El redondeo de la capacidad es una función opcional que está desactivada de forma predeterminada y debe activarse según StorageClass. Los StorageClasses existentes no se ven afectados.

Esta característica solo se aplica a los perfiles dp2 StorageClasses que utilizan un aprovisionamiento de IOPS fijo. No se aplica a las clases de perfil rfs.

  1. Crea un archivo de configuración de StorageClass que establezca allowCapacityRoundoffForIops: "true" en la sección parameters.

    El siguiente ejemplo crea un StorageClass con un valor de IOPS válido y el redondeo de capacidad activado:

    apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: ibmc-vpc-file-dp2-roundoff
  labels:
    app.kubernetes.io/name: ibm-vpc-file-csi-driver
provisioner: vpc.file.csi.ibm.io
allowVolumeExpansion: true
reclaimPolicy: Delete
mountOptions:
  - hard
  - nfsvers=4.1
  - sec=sys
parameters:
  allowCapacityRoundoffForIops: "true"
  billingType: hourly
  classVersion: "1"
  encrypted: "false"
  encryptionKey: ""
  gid: "0"
  iops: "4700"
  isENIEnabled: "true"
  primaryIPAddress: ""
  primaryIPID: ""
  profile: dp2
  region: ""
  resourceGroup: ""
  securityGroupIDs: ""
  subnetID: ""
  tags: ""
  uid: "0"
  zone: ""
volumeBindingMode: Immediate

  2. Aplica el StorageClass a tu clúster.

    oc apply -f ibmc-vpc-file-dp2-roundoff.yaml

  3. Comprueba que el servicio StorageClass esté disponible en tu clúster. Busca el nombre que has especificado en el resultado.

    oc get sc

Aprovisionar un PVC con redondeo de capacidad

Una vez creado el StorageClass,, crea un PVC que haga referencia a él. Los siguientes ejemplos muestran los dos principales escenarios de aprovisionamiento.

Escenario 1: La capacidad está por debajo del mínimo y se redondea al alza

En este ejemplo, el PVC solicita 80 Gi de almacenamiento. Dado que 80 Gi está por debajo de la capacidad mínima admitida para 4700 IOPS, el controlador aprovisiona automáticamente el recurso compartido de archivos con la capacidad mínima admitida (100 Gi en este caso).

  1. Crea un archivo de configuración de PVC.

    apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-roundoff-pvc
  namespace: default
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 80Gi
  storageClassName: ibmc-vpc-file-dp2-roundoff

  2. Aplica el PVC.

    oc apply -f my-roundoff-pvc.yaml

  3. Comprueba que el PVC esté vinculado y toma nota del campo CAPACITY en la salida. La capacidad debe reflejar el valor redondeado al alza, no los 80 Gi que se solicitaron.

    oc get pvc my-roundoff-pvc

    Salida de ejemplo:

    NAME              STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS                  AGE
my-roundoff-pvc   Bound    pvc-91ff9a52-5004-4441-9611-be5410edbfe4   100Gi      RWX            ibmc-vpc-file-dp2-roundoff    30s

    El valor CAPACITY es, aunque 100Gi 80Gi se solicitó, lo que confirma que el controlador redondeó al alza hasta la capacidad mínima admitida.

Escenario 2: La capacidad cumple con el mínimo y se aprovisiona según lo solicitado

En este ejemplo, el PVC solicita 200 Gi, lo que ya cumple con la capacidad mínima admitida para 4700 IOPS. El controlador configura el recurso compartido de archivos con la capacidad solicitada sin necesidad de ajustes.

  1. Crea un archivo de configuración de PVC.

    apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-exact-pvc
  namespace: default
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 200Gi
  storageClassName: ibmc-vpc-file-dp2-roundoff

  2. Aplica el PVC.

    oc apply -f my-exact-pvc.yaml

  3. Comprueba que el PVC esté vinculado. El campo CAPACITY debe mostrar 200Gi, lo que confirma que no se ha realizado ningún ajuste.

    oc get pvc my-exact-pvc

    Salida de ejemplo:

    NAME           STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS                  AGE
my-exact-pvc   Bound    pvc-3528044b-b004-4077-b09f-c6cdf7000180   200Gi      RWX            ibmc-vpc-file-dp2-roundoff    24m

Próximos pasos