Gestión de IBM Cloud File Storage for VPC

Cuando configure el almacenamiento persistente en su cluster, dispondrá de tres componentes principales: la petición de volumen persistente (PVC) Kubernetes que solicita el almacenamiento, el volumen persistente (PV) Kubernetes que se monta en un pod y se describe en el PVC, y el archivo compartido. En función de cómo haya creado el almacenamiento, es posible que los tenga que suprimir los tres componentes por separado.

Se aplican las siguientes limitaciones al complemento.

Se recomienda que su clúster y VPC formen parte del mismo grupo de recursos. Si su clúster y VPC están en grupos de recursos separados, antes de poder aprovisionar recursos compartidos de archivos, debe crear su propia clase de almacenamiento y proporcionar su ID de grupo de recursos de VPC. Para más información, ver Creando tu propia clase de almacenamiento.
Se introdujeron nuevas reglas de grupo de seguridad en las versiones de clúster. 4.11 y después. Estos cambios de reglas significan que debes sincronizar tus grupos de seguridad antes de poder usarFile Storage for VPC. Para más información, ver AñadiendoFile Storage for VPC a aplicaciones.
Se agregaron nuevas clases de almacenamiento con la versión2.0 del complemento. Ya no puede aprovisionar nuevos recursos compartidos de archivos que utilicen clases de almacenamiento más antiguas. Los volúmenes existentes que utilizan las clases de almacenamiento más antiguas siguen funcionando; sin embargo, no se pueden expandir los volúmenes que se crearon utilizando las clases más antiguas. Para obtener más información, consulte la Migrar a una nueva clase de almacenamiento.

Actualización del complemento de clúster File Storage for VPC

Acceda al clúster de Red Hat OpenShift.

Obtenga el ID del clúster.
```
ibmcloud oc cluster ls
```
Revise las versiones de complementos disponibles.
```
ibmcloud oc cluster addon versions
```

Inhabilite el complemento.

ibmcloud oc cluster addon disable vpc-file-csi-driver --cluster CLUSTER

Habilite la versión más reciente del complemento.

ibmcloud oc cluster addon enable vpc-file-csi-driver --cluster CLUSTER --version VERSION

Verifique que el complemento esté habilitado ejecutando los mandatos siguientes.

oc get deploy -n kube-system | grep file

ibm-vpc-file-csi-controller   2/2     2            2           13m

oc get ds -n kube-system | grep file

ibm-vpc-file-csi-node    2         2         2       2            2           <none>          14m

oc get pods -n kube-system  | grep file

ibm-vpc-file-csi-controller-7899db784-kc29g   5/5     Running   0             14m
ibm-vpc-file-csi-controller-7899db784-mp5jt   5/5     Running   0             14m
ibm-vpc-file-csi-node-bfqdz                   4/4     Running   0             14m
ibm-vpc-file-csi-node-n7jbx                   4/4     Running   0             14m

Establecimiento de límites de recursos y solicitudes en el configmap

Ejecute el mandato siguiente para editar el configmap.

oc edit cm addon-vpc-file-csi-driver-configmap -n kube-system

Ejemplo de salida.

apiVersion: v1
data:
  CSIBlockDriverCPULimit: 300m
  CSIBlockDriverCPURequest: 75m
  CSIBlockDriverMemoryLimit: 600Mi
  CSIBlockDriverMemoryRequest: 150Mi
  CSIDriverRegistrarCPULimit: 40m
  CSIDriverRegistrarCPURequest: 10m
  CSIDriverRegistrarMemoryLimit: 80Mi
  CSIDriverRegistrarMemoryRequest: 20Mi
  CSILivenessProbeCPULimit: 20m
  CSILivenessProbeCPURequest: 5m
  CSILivenessProbeMemoryLimit: 40Mi
  CSILivenessProbeMemoryRequest: 10Mi
  CSINodeDriverCPULimit: 120m
  CSINodeDriverCPURequest: 30m
  CSINodeDriverMemoryLimit: 300Mi
  CSINodeDriverMemoryRequest: 75Mi
  CSIProvisionerCPULimit: 80m
  CSIProvisionerCPURequest: 20m
  CSIProvisionerMemoryLimit: 160Mi
  CSIProvisionerMemoryRequest: 40Mi
  CSIResizerCPULimit: 80m
  CSIResizerCPURequest: 20m
  CSIResizerMemoryLimit: 160Mi
  CSIResizerMemoryRequest: 40Mi
  EIT_ENABLED_WORKER_POOLS: ""
  ENABLE_EIT: "false"
  SET_DEFAULT_STORAGE_CLASS: ""
  SecretSidecarCPULimit: 60m
  SecretSidecarCPURequest: 15m
  SecretSidecarMemoryLimit: 80Mi
  SecretSidecarMemoryRequest: 20Mi
kind: ConfigMap
metadata:
  creationTimestamp: "2025-06-19T11:23:13Z"
  labels:
    app.kubernetes.io/name: ibm-vpc-file-csi-driver
  name: addon-vpc-file-csi-driver-configmap

Edite los parámetros según sea necesario y, a continuación, guarde el archivo.

Inhabilitación del complemento

La inhabilitación de vpc-file-csi-driver elimina los paquetes de cifrado en tránsito de los nodos trabajadores.

Ejecute el siguiente comando para desactivar el complemento.

ibmcloud oc cluster addon disable --addon vpc-file-csi-driver --cluster CLUSTER

Verifique que los pods se han eliminado.

oc get pods -n kube-system  | grep file

Visión general de la eliminación del almacenamiento

El etiquetado no era compatible con la versión 1.2. Esto afecta a la eliminación de comparticiones de archivos cuando se suprime un clúster con la opción --force-delete-storage. Asegúrese de limpiar todos los PVC creados con la versión 1.2 del complemento antes de eliminar el clúster.

La eliminación del almacenamiento persistente de la cuenta de IBM Cloud varía en función de cómo haya suministrado el almacenamiento y de los componentes que ya haya eliminado.

¿Se elimina mi almacenamiento persistente cuando borro mi clúster?: Durante la supresión del clúster, tiene la opción de eliminar el almacenamiento persistente. Sin embargo, en función de cómo se haya suministrado el almacenamiento, es posible que la eliminación del almacenamiento no incluya todos los componentes de almacenamiento. Si aprovisionó almacenamiento dinámicamente con una clase de almacenamiento que establece reclaimPolicy: Delete, su PVC, PV y la instancia de almacenamiento se eliminan automáticamente al eliminar el clúster. Para el almacenamiento que se aprovisionó estáticamente o el almacenamiento que aprovisionó con una clase de almacenamiento que establece reclaimPolicy: Retain, el PVC y el PV se eliminan cuando elimina el clúster, pero su instancia de almacenamiento y sus datos permanecen. Se le sigue facturando la instancia de almacenamiento. Además, si ha suprimido el clúster que no está en buen estado, es posible que el almacenamiento siga existiendo incluso si ha elegido eliminarlo.
¿Cómo elimino el almacenamiento si quiero conservar mi clúster?: Cuando se ha suministrado el almacenamiento de forma dinámica con una clase de almacenamiento que establece reclaimPolicy: Delete, puede eliminar la PVC para iniciar el proceso de supresión de su almacenamiento persistente. La PVC, el PV y la instancia de almacenamiento se eliminan automáticamente. Para el almacenamiento que se aprovisionó estáticamente o el almacenamiento que aprovisionó con una clase de almacenamiento que establece reclaimPolicy: Retain, debe eliminar manualmente el PVC, el PV y la instancia de almacenamiento para evitar más cargos.
¿Cómo se detiene la facturación después de borrar mi almacenamiento?: En función de los componentes de almacenamiento que suprima y de cuándo lo haga, es posible que el ciclo de facturación no se detenga inmediatamente. Si suprime la PVC y el PV, pero no la instancia de almacenamiento de la cuenta de IBM Cloud, dicha instancia sigue existiendo y se le sigue facturando por la misma.

Si suprime la PVC, el PV y la instancia de almacenamiento, el ciclo de facturación se detiene en función del valor de billingType que haya elegido al suministrar el almacenamiento y de cómo haya elegido suprimir el almacenamiento.

Cuando cancela manualmente la instancia de almacenamiento persistente desde la consola IBM Cloud o la CLI, la facturación se detiene de la siguiente manera:
- Almacenamiento por hora: la facturación se detiene inmediatamente. Una vez que se haya cancelado el almacenamiento, es posible que siga viendo la instancia de almacenamiento en la consola durante 72 horas más.
- Almacenamiento mensual: puede elegir entre cancelación inmediata o cancelación al cumplirse el año. En ambos casos, se le factura hasta el final del ciclo de facturación actual y la facturación se detiene en el siguiente ciclo de facturación. Una vez que se haya cancelado el almacenamiento, es posible que siga viendo la instancia de almacenamiento en la consola o la CLI durante 72 horas más.
- Cancelación inmediata: elija esta opción para eliminar el almacenamiento de inmediato. Ni usted ni sus usuarios pueden seguir utilizando el almacenamiento ni recuperar los datos.
- Fecha de aniversario: elija esta opción para cancelar el almacenamiento en la fecha del próximo aniversario. Las instancias de almacenamiento permanecen activas hasta la fecha del siguiente aniversario y puede seguir utilizándolas hasta dicha fecha, por ejemplo para dar tiempo a su equipo para que realice copias de seguridad de los datos.
Si ha suministrado el almacenamiento de forma dinámica con una clase de almacenamiento que establece reclaimPolicy: Delete y elige eliminar la PVC, el PV y la instancia de almacenamiento se eliminan inmediatamente. En el caso del almacenamiento que se factura por hora, la facturación se detiene inmediatamente. En el caso del almacenamiento que se factura mensualmente, se le factura el resto del mes. Una vez que se haya eliminado el almacenamiento y se detiene la facturación, es posible que siga viendo la instancia de almacenamiento en la consola o la CLI durante 72 horas más.

¿Qué debo tener en cuenta antes de eliminar el almacenamiento permanente?: Cuando se limpia el almacenamiento persistente, se suprimen todos los datos almacenados en el mismo. Si necesita una copia de los datos, haga una copia de seguridad.
He borrado mi instancia de almacenamiento. ¿Por qué sigo viendo mi instancia?: Después de eliminar el almacenamiento persistente, pueden pasar hasta 72 horas hasta que la eliminación se procese por completo y el almacenamiento desaparezca de la consola o de la CLI de IBM Cloud.

Limpieza del almacenamiento persistente

Elimine la PVC, el PV y la instancia de almacenamiento de la cuenta de IBM Cloud para evitar cargos adicionales de almacenamiento persistente.

Antes de empezar:

Asegúrese de que ha realizado una copia de seguridad de los datos que desea conservar.
Acceda al clúster de Red Hat OpenShift.

Para limpiar los datos persistentes:

Obtenga una lista de las PVC del clúster y anote el nombre (NAME) de la PVC, su STORAGECLASS y el nombre del PV vinculado a la PVC que se muestra como VOLUME.

oc get pvc

Salida de ejemplo

NAME                  STATUS    VOLUME                                     CAPACITY   ACCESSMODES   STORAGECLASS            AGE
claim1   Bound     pvc-06886b77-102b-11e8-968a-f6612bb731fb   20Gi       RWO           class       78d
claim2     Bound     pvc-457a2b96-fafc-11e7-8ff9-b6c8f770356c   4Gi        RWX           class 105d
claim3      Bound     pvc-1efef0ba-0c48-11e8-968a-f6612bb731fb   24Gi       RWX           class        83d

Revise los valores ReclaimPolicy y billingType para la clase de almacenamiento.
```
oc describe storageclass <storageclass_name>
```
Si la política de reclamación indica Delete, el PV y el almacenamiento físico se eliminan cuando se elimina la PVC. Si la política de reclamación indica Retain, o si ha suministrado el almacenamiento sin una clase de almacenamiento, el PV y el almacenamiento físico no se eliminan cuando se elimina la PVC. Debe eliminar la PVC, el PV y el almacenamiento físico por separado.

Si el almacenamiento se carga de forma mensual, se le facturará todo el mes, aunque elimine el almacenamiento antes de que finalice el ciclo de facturación.

Elimine los pods que montan la PVC. Obtenga una lista de los pods que montan la PVC. Si no se devuelve ningún pod en la salida de la CLI, no tiene ningún pod que utilice la PVC.

oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"

Salida de ejemplo

depl-12345-prz7b:    claim1

Elimine el pod que utiliza la PVC. Si el pod forma parte de un despliegue, elimine el despliegue.
```
oc delete pod <pod_name>
```
Verifique que el pod se ha eliminado.
```
oc get pods
```
Elimine la PVC.
```
oc delete pvc <pvc_name>
```
Revise el estado de su PV. Utilice el nombre del PV que ha recuperado antes como VOLUME. Cuando se elimina la PVC, se libera el PV vinculado a la PVC. En función de cómo haya suministrado el almacenamiento, el PV entra en estado Deleting si el PV se suprime automáticamente o en estado Released si debe suprimir manualmente el PV. Nota: para los PV que se suprimen automáticamente, el estado puede indicar brevemente Released antes de que se suprima. Vuelva a ejecutar el mandato después de unos minutos para ver si se ha eliminado el PV.
```
oc get pv <pv_name>
```
Si su PV no se ha suprimido, elimine manualmente el PV.
```
oc delete pv <pv_name>
```
Verifique que el PV se ha eliminado.
```
oc get pv
```
Liste sus recursos compartidos.
```
ibmcloud is shares
```
Liste cada compartición de archivos y busque el ID de clúster asociado.
```
ibmcloud is share SHARE | grep CLUSTER-ID
```

Suprima las comparticiones.

ibmcloud is share-delete (SHARE1 SHARE2 ...)