Comprender la creación y eliminación de cubos

• Puede utilizar un cubo existente especificando el nombre del cubo en su PVC.
• Si proporciona un nombre de cubo y ese cubo no existe, se creará un cubo con ese nombre.
• Si no proporciona un nombre de cubo, se creará un cubo con la convención de nomenclatura temp-xxx.
• Los cubos se eliminan en función de la política de recuperación definida en la clase de almacenamiento.
  • Si se establece reclaimPolicy: Delete, el cubo se elimina cuando se elimina el PVC.
  • Si se establece reclaimPolicy: Retain, el bucket se conserva incluso después de eliminar el PVC.

Restricción de la programación de pods de nodoserver

De forma predeterminada, los pods del servidor de nodos del controlador COS CSI se programan en todos los nodos del clúster. Puedes utilizar el parámetro « restrictNodeServerScheduling » para restringir la programación de los pods de nodeserver únicamente a los nodos etiquetados con « cos.csi.ibm.io/csi-node=true ».

Puedes configurar « restrictNodeServerScheduling » al habilitar el complemento, o actualizarlo más adelante aplicando el parche « ConfigMap ».

• Para establecer « restrictNodeServerScheduling » al habilitar el complemento, incluye el indicador « --param » en el comando de habilitación.

  ibmcloud oc cluster addon enable ibm-object-csi-driver --cluster CLUSTER --param "restrictNodeServerScheduling=true"
  

• Para actualizar « restrictNodeServerScheduling » una vez que el complemento ya esté activado, sigue estos pasos.

1. Enumera los nodos de tu clúster y determina dónde quieres que se ejecuten los pods del controlador COS.

   oc get nodes
   

   Salida de ejemplo

   NAME            STATUS   ROLES    AGE    VERSION
   10.241.0.11     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.0.12     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.0.13     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.10   Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.11   Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.9    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.12    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.13    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.14    Ready    <none>   5d2h   v1.35.5+IKS
   

2. Comprueba que los pods de nodeserver estén actualmente en ejecución en todos los nodos.

   oc get pods -n ibm-object-csi-operator -l app.kubernetes.io/component=node -o wide
   

   Salida de ejemplo

   NAME                        READY   STATUS    RESTARTS   AGE    IP              NODE            NOMINATED NODE   READINESS GATES
   ibm-object-csi-node-2pj2j   3/3     Running   0          145m   172.17.14.10    10.241.0.12     <none>           <none>
   ibm-object-csi-node-7bhwh   3/3     Running   0          145m   172.17.1.72     10.241.65.12    <none>           <none>
   ibm-object-csi-node-7l9hc   3/3     Running   0          145m   172.17.17.6     10.241.128.9    <none>           <none>
   ibm-object-csi-node-cxzt7   3/3     Running   0          145m   172.17.39.72    10.241.0.11     <none>           <none>
   ibm-object-csi-node-dw6qs   3/3     Running   0          145m   172.17.46.77    10.241.128.10   <none>           <none>
   ibm-object-csi-node-rpcvr   3/3     Running   0          145m   172.17.32.198   10.241.65.13    <none>           <none>
   ibm-object-csi-node-swqtg   3/3     Running   0          145m   172.17.16.69    10.241.0.13     <none>           <none>
   ibm-object-csi-node-sxbbs   3/3     Running   0          145m   172.17.26.7     10.241.65.14    <none>           <none>
   ibm-object-csi-node-xm8bt   3/3     Running   0          145m   172.17.20.200   10.241.128.11   <none>           <none>
   

3. Etiqueta los nodos en los que quieras que se programen los pods de nodeserver.

   oc label nodes NODE-NAME-1 NODE-NAME-2 cos.csi.ibm.io/csi-node=true
   

   Salida de ejemplo

   node/10.241.0.11 labeled
   node/10.241.0.12 labeled
   

4. Activa la restricción actualizando el archivo « ConfigMap ».

   oc patch cm managed-addon-ibm-object-csi-driver -n kube-system \
     --type merge -p '{"data":{"restrictNodeServerScheduling":"true"}}'
   

   Salida de ejemplo

   configmap/managed-addon-ibm-object-csi-driver patched
   

5. Comprueba que los pods de nodeserver solo se programen en nodos etiquetados.

   oc get pods -n ibm-object-csi-operator -l app.kubernetes.io/component=node -o wide
   

   Salida de ejemplo

   NAME                        READY   STATUS    RESTARTS   AGE    IP             NODE           NOMINATED NODE   READINESS GATES
   ibm-object-csi-node-cxzt7   3/3     Running   0          145m   172.17.39.72   10.241.0.11    <none>           <none>
   ibm-object-csi-node-7bhwh   3/3     Running   0          145m   172.17.1.72    10.241.65.12   <none>           <none>
   

Configuración de los volúmenes máximos por nodo

Por defecto, el controlador COS CSI no limita el número de volúmenes que se pueden montar en un único nodo. Puedes utilizar el parámetro « maxVolumesPerNode » para establecer el número máximo de volúmenes por nodo.

Puedes configurar « maxVolumesPerNode » al habilitar el complemento, o actualizarlo más adelante aplicando el parche « ConfigMap ».

• Para establecer « maxVolumesPerNode » al habilitar el complemento, incluye el indicador « --param » en el comando de habilitación.

  ibmcloud oc cluster addon enable ibm-object-csi-driver --cluster CLUSTER --param "maxVolumesPerNode=VALUE"
  

• Para actualizar maxVolumesPerNode una vez que el complemento ya esté activado, aplica el parche al complemento gestionado ConfigMap.

  oc patch cm managed-addon-ibm-object-csi-driver -n kube-system --type merge -p '{"data":{"maxVolumesPerNode":"VALUE"}}'
  

  Salida de ejemplo

  configmap/managed-addon-ibm-object-csi-driver patched
  

Implementación de una aplicación que utiliza IBM Cloud Object Storage

cos.csi.driver/secret: "<custom-secret>"

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: cos-secret-1 # Give your PVC the same name as the secret you created in the previous step.
  namespace: <namespace> # The namespace where you want to create the PVC.
spec:
  accessModes:
  - ReadWriteMany
  resources:
    requests:
      storage: 10Gi
  storageClassName: <storage_class_name> # The storage class you want to use.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: cos-csi-pvc1
  namespace: <namespace> # The namespace where you want to create the PVC.
  annotations:
    cos.csi.driver/secret: "<custom-secret>"
spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 256Mi
  storageClassName: <storage_class_name> # The storage class you want to use.

Desactivación del complemento IBM Cloud Object Storage

Los secretos, PVCs y despliegues existentes no se eliminan al desactivar el complemento ni con las actualizaciones de parches. No hay interrupciones en las cargas de trabajo existentes de los clientes.

1. Ejecuta el siguiente comando para desactivar el complemento.

    ibmcloud oc cluster addon disable ibm-object-csi-driver --cluster CLUSTER
   

   Salida de ejemplo

   Data and resources that you created for the add-on might be deleted when the add-on is disabled. Continue? [y/N]> y
   Disabling add-on ibm-object-csi-driver for cluster XXX...
   OK
   

2. Comprueba que se haya eliminado el complemento.

   ibmcloud oc cluster addon ls --cluster CLUSTER
   

Migración del complemento Helm al complemento clúster

1. Acceda al clúster de Red Hat OpenShift.

2. Obtenga los detalles de sus PVC y seleccione uno para migrar.

   oc get pvc --all-namespaces -o custom-columns='NAMESPACE:.metadata.namespace,NAME:.metadata.name' | tail -n +2 | while read namespace pvc; do kubectl describe pvc "$pvc" -n "$namespace" | grep 'volume.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs' > /dev/null ; if [ $? -eq 0 ]; then echo "PVC: $pvc in Namespace: $namespace uses ibm.io/ibmc-s3fs storage provisioner"; fi; done
   

   Salida de ejemplo

   PVC: pvc-test in Namespace: default uses ibm.io/ibmc-s3fs storage provisioner
   

3. Describe el PVC y obtén el nombre del cubo.

   oc describe pvc <pvc_name> | grep ibm.io/bucket:
   

   Salida de ejemplo

   ibm.io/bucket: test-s3
   

4. Vuelve a crear tu secreto con el nombre del cubo incluido.

   apiVersion: v1
   kind: Secret
   type: cos-s3-csi-driver
   metadata:
       name: cos-secret-1 # Name your secret.
       namespace: <namespace> # Specify the namespace where you want to create the secret.
   data:
       accessKey: <base64-encoded-HMAC-access-key>
       secretKey: <base64-encoded-HMAC-secret-key>
   stringData:
       bucketName: <bucket-name>
       # uid: "3000" # Optional: Provide a uid to run as non root user. This must match runAsUser in SecurityContext of pod spec.
       mountOptions: |
           key1=value1
           key2=value2
   

5. Busque la clase de almacenamiento que se utilizó en su PVC.

   oc describe pvc <pvc_name> | grep StorageClass:
   

   Ejemplo de comando para un PVC llamado test-s3.

   oc describe pvc test-s3 | grep StorageClass:
   

   Salida de ejemplo

   StorageClass:  ibmc-s3fs-smart-perf-regional
   

6. Revise las nuevas clases de almacenamiento disponibles con el complemento y seleccione una clase de sustitución.

   • Si utilizó una clase flex, elija una de las nuevas clases smart.
   • Si utilizó una clase standard, elija una de las nuevas clases standard.
   • Las clases cold y vault ya no están disponibles con el complemento; elija en su lugar una clase smart o standard.

7. Revise los detalles de su PVC.

   oc describe pvc test-s3
   

   Salida de ejemplo

   Name:          pvc-test
   Namespace:     default
   StorageClass:  ibmc-s3fs-smart-perf-regional
   Status:        Bound
   Volume:        pvc-c625474d-31f0-4929-bc3e-feace1fb42fb
   Labels:        <none>
   Annotations:   ibm.io/auto-create-bucket: true
               ibm.io/auto-delete-bucket: true
               ibm.io/bucket: bha-test-s23
               ibm.io/secret-name: satstoragesecret
               pv.kubernetes.io/bind-completed: yes
               pv.kubernetes.io/bound-by-controller: yes
               volume.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs
   Finalizers:    [kubernetes.io/pvc-protection]
   Capacity:      3Gi
   Access Modes:  RWO
   VolumeMode:    Filesystem
   Used By:       test-pod
   Events:        <none>
   

8. Crea un PVC de sustitución que utilice una nueva clase de almacenamiento y haga referencia al secreto que creaste anteriormente.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
   name: cos-csi-pvc1
   namespace: <namespace> # The namespace where you want to create the PVC.
   annotations:
       cos.csi.driver/secret: "cos-secret-1"  # Secret created in step 4
   spec:
   accessModes:
   - ReadWriteOnce
   resources:
       requests:
       storage: 256Mi
   storageClassName: <storage_class_name> # The storage class you picked based on old storage class mapping.
   

9. Verifique que el PVC es Bound.

   oc get pvc
   

10. Consulta los detalles de tu aplicación.

    oc get pods
    

11. Reduzca su aplicación a cero.

    kubectl scale deployment --replicas=0 my-app
    

12. Cree una implantación de sustitución que haga referencia a la PVC creada en el paso anterior.

13. Una vez que se haya ejecutado la nueva implantación, puede eliminar la antigua.

14. Repite estos pasos para cada PVC que quieras migrar.

IBM Cloud Object Storage clases de almacenamiento de clústeres adicionales

El complemento de clúster IBM Cloud Object Storage proporciona clases de almacenamiento para los montadores s3fs y rclone. Elija una clase de almacenamiento que se ajuste a sus requisitos de acceso a datos. La clase de almacenamiento determina la clase de bucket, la política de recuperación y el comportamiento de montaje predeterminado para el bucket que se crea para su carga de trabajo.

Standard

Utilízalo para datos calientes a los que accedes con frecuencia, como datos para aplicaciones web o móviles.

Inteligente

Se utiliza para cargas de trabajo y datos que no siguen un patrón de uso específico, o cuando el patrón de uso es difícil de predecir.

Para revisar la configuración detallada de los cubos de una clase de almacenamiento, ejecute oc describe storageclass <storageclass_name> o oc describe storageclass <storageclass_name>.