Abilitazione dell'arrotondamento automatico della capacità per i profili IOPS fissi

Grazie alla funzione di arrotondamento della capacità del driver CSI per file VPC di IBM, è possibile consentire al driver di regolare automaticamente la capacità richiesta di un claim di volume persistente (PVC) qualora questa risulti inferiore alla capacità minima supportata per il profilo IOPS fisso selezionato. In questo modo non è più necessario calcolare manualmente i valori di capacità minima prima di configurare le condivisioni di file.

Come funziona l'arrotondamento della capacità

All'avvio del driver, il driver CSI per file VPC di IBM recupera un catalogo delle capacità supportate in relazione agli IOPS dal Catalogo globale di IBM. Il catalogo viene memorizzato nella cache e utilizzato per tutte le successive richieste di provisioning. La tabella seguente illustra il comportamento del driver durante il provisioning del PVC.

Comportamento dell'allocazione delle risorse in caso di arrotondamento della capacità
Scenario Driver Behavior
Gli IOPS richiesti sono supportati e la capacità richiesta è inferiore al minimo Il driver arrotonda la capacità al valore minimo supportato e alloca il PVC.
Gli IOPS richiesti sono supportati e la capacità richiesta soddisfa i requisiti minimi Il PVC è disponibile nella quantità richiesta.
Il numero di IOPS richiesto non è supportato Il provisioning non va a buon fine a causa di un errore di convalida. Per ricevere assistenza nella risoluzione di questo errore, consultare la sezione " Risoluzione dei problemi relativi all'arrotondamento della capacità ".

Se il Catalogo globale risulta irraggiungibile all'avvio del driver, viene registrato un avviso e la funzione di arrotondamento della capacità non è disponibile. Tutte le altre operazioni di provisioning procedono come previsto.

Prerequisiti

Prima di abilitare l'arrotondamento della capacità, il driver deve essere in grado di accedere a un Catalogo glob IBM. Per consentire l'accesso, configura un Virtual Private Endpoint Gateway (VPEG) nella tua VPC.

  1. Crea un gateway endpoint privato virtuale nella tua VPC per il servizio Catalogo risorse globale.

    Quando si crea il VPEG, configurare le seguenti impostazioni:

    • Nella sezione Servizi cloud, selezionare Catalogo risorse globale.
    • Nella sezione " Endpoint disponibili ", selezionare l'endpoint con il tipo di endpoint api e URL private.globalcatalog.cloud.ibm.com oppure *.private.globalcatalog.cloud.ibm.com.

    Utilizza i nomi esatti dei servizi e gli URL così come riportati nell'interfaccia utente di IBM Cloud.

  2. Verifica che i nodi del cluster siano in grado di raggiungere l'endpoint privato del Catalogo globale. In assenza di connessione, il driver visualizza un messaggio di avviso all'avvio e la funzione di arrotondamento della capacità non è disponibile. Tutte le altre operazioni di provisioning procedono come previsto.

Crea un " StorageClass " con l'arrotondamento della capacità abilitato

L'arrotondamento della capacità è una funzionalità opzionale disattivata per impostazione predefinita e che deve essere abilitata come indicato all'indirizzo StorageClass. StorageClasses, già esistenti, non sono interessati.

Questa funzionalità si applica esclusivamente ai profili dp2 StorageClasses che utilizzano il provisioning IOPS fisso. Non si applica alle classi di profilo " rfs ".

  1. Creare un file di configurazione StorageClass che imposti allowCapacityRoundoffForIops: "true" nella sezione parameters.

    L'esempio seguente crea un'unità " StorageClass " con un valore IOPS valido e l'arrotondamento della capacità abilitato:

    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. Applica l' StorageClass e al tuo cluster.

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

  3. Verificare che il servizio " StorageClass " sia disponibile nel proprio cluster. Cerca il nome che hai specificato nell'output.

    oc get sc

Fornire un PVC con arrotondamento della capacità

Dopo aver creato il tuo StorageClass,, crea un PVC che faccia riferimento ad esso. Gli esempi seguenti illustrano i due principali scenari di provisioning.

Scenario 1: La capacità è inferiore al minimo e viene arrotondata per eccesso

In questo esempio, il PVC richiede 80 Gi di spazio di archiviazione. Poiché 80 Gi è inferiore alla capacità minima supportata per 4700 IOPS, il driver configura automaticamente la condivisione di file alla capacità minima supportata (100 Gi in questo caso).

  1. Creare un file di configurazione 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. Applicare il PVC.

    oc apply -f my-roundoff-pvc.yaml

  3. Verificare che il PVC sia associato e prendere nota del campo “ CAPACITY ” nell’output. La capacità dovrebbe corrispondere al valore arrotondato per eccesso, non agli 80 Gi richiesti.

    oc get pvc my-roundoff-pvc

    Output di esempio:

    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

    Il valore " CAPACITY " è 100Gi, anche se era stato richiesto 80Gi ; ciò conferma che il driver ha arrotondato per eccesso alla capacità minima supportata.

Scenario 2: La capacità soddisfa i requisiti minimi e le disposizioni richieste

In questo esempio, il PVC richiede 200 Gi, il che soddisfa già la capacità minima supportata per 4700 IOPS. Il driver configura la condivisione di file alla capacità richiesta senza alcuna regolazione.

  1. Creare un file di configurazione 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. Applicare il PVC.

    oc apply -f my-exact-pvc.yaml

  3. Verificare che il PVC sia fissato. Il campo " CAPACITY " dovrebbe visualizzare " 200Gi", a conferma che non è stata effettuata alcuna modifica.

    oc get pvc my-exact-pvc

    Output di esempio:

    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

Passi successivi