Requisitos previos para ODF

Nodos de trabajo de metal desnudo con almacenamiento NVME local

Utilice versiones con el sufijo d que incluyan discos NVME locales.

Requisitos de los nodos de trabajo

ODF requiere al menos 3 nodos trabajadores para una alta disponibilidad y redundancia de datos.

Configuración de zonas

• OpenShift Despliegues de virtualización: Se recomiendan los clústeres de zona única para minimizar la latencia del almacenamiento en las cargas de trabajo de VM. Aunque los despliegues multizona ofrecen una mayor disponibilidad, la replicación de almacenamiento entre zonas puede afectar al rendimiento de VM.
• Despliegues generales de ODF: Se recomiendan al menos 3 zonas para alta disponibilidad y recuperación de desastres.

Instalación de ODF desde la consola

1. Inicie sesión en su cuenta de IBM Cloud y navegue hasta su clúster.

2. Haga clic en Complementos en la navegación del clúster.

3. En la tarjeta « OpenShift Data Foundation », haz clic en « Instalar ».

4. Seleccione la opción Almacenamiento local.

   La conexión remota de volúmenes de bloques no es compatible con los nodos VPC bare metal.

5. Elige uno de los siguientes métodos de búsqueda:

   Descubrimiento automático (recomendado)

   Seleccione Detección automática para detectar y utilizar automáticamente los discos disponibles en sus nodos trabajadores de metal desnudo.

   Especificación manual del disco

   Si prefiere especificar los discos manualmente, siga estos pasos:

   1. Inicie sesión en cada nodo trabajador para identificar los discos disponibles.

      oc debug node/<node-name>
      

   2. Permita los binarios de host.

      chroot /host
      

   3. Lista de dispositivos disponibles.

      lsblk
      

   4. Encuentra el by-id de cada disco.

      ls -l /dev/disk/by-id/
      

   5. Añade los ID de disco en el parámetro ID de disco de pod OSD.

6. Configure parámetros adicionales según sea necesario:

   • Perfil de recursos: Elija balanced o performance en función de su carga de trabajo
   • Cifrado: Habilite el cifrado con Hyper Protect Crypto Services si es necesario
   • Número de discos OSD: Especifica el número de discos por nodo trabajador

7. Haga clic en Instalar para desplegar ODF.

Para obtener más información sobre los parámetros ODF, consulte OpenShift Referencia de parámetros de Data Foundation.

Instalación de ODF desde la línea de comandos

1. Consulta las opciones de complementos disponibles.

   ibmcloud oc cluster addon options --addon openshift-data-foundation --version 4.20.0
   

2. Active el complemento OpenShift Data Foundation con detección automática de discos y compatibilidad con la virtualización.

   ibmcloud oc cluster addon enable openshift-data-foundation \
     -c <cluster-name> \
     --version 4.20.0 \
     --param "odfDeploy=true" \
     --param "osdStorageClassName=localblock" \
     --param "autoDiscoverDevices=true" \
     --param "resourceProfile=performance" \
     --param "setDefaultStorageClassForVirtualization=true"
   

3. Comprueba que el complemento se encuentre en estado «Listo».

   oc get storagecluster -n openshift-storage
   

   Salida de ejemplo:

   NAME                 AGE   PHASE   EXTERNAL   CREATED AT             VERSION
   ocs-storagecluster   53m   Ready              2025-03-10T12:20:52Z   4.20.0
   

Verificación de la instalación de ODF

1. Compruebe el estado del clúster de almacenamiento.

   oc get storagecluster -n openshift-storage
   

2. Compruebe que las clases de almacenamiento están disponibles.

   oc get storageclass | grep ocs
   

3. Confirme que los pods ODF se están ejecutando.

   oc get pods -n openshift-storage
   

Para obtener más información sobre la implementación de ODF, consulte Implementación de OpenShift Data Foundation en clústeres VPC.

Requisitos previos para VPC File Storage

• Cualquier versión de «bare metal» compatible
• Infraestructura de VPC

Paso 1: Desactivar la opción « Block Storage » de VPC como valor predeterminado

1. Edita el mapa de configuración del controlador CSI de VPC Block.

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

2. Establece « IsStorageClassDefault » en « false ».

   data:
     IsStorageClassDefault: "false"
   

3. Guarde y salga del editor.

Paso 2: Instalar el controlador CSI del archivo VPC

Paso 3: Establecer una clase de almacenamiento predeterminada

1. Obtenga una lista de las clases de almacenamiento disponibles.

   oc get storageclass | grep vpc-file
   

2. Elige una clase de almacenamiento adecuada en función de tu carga de trabajo:

   • ibmc-vpc-file-1000-iops: Para cargas de trabajo moderadas (40 GB - 2000 IOPS)
   • ibmc-vpc-file-6000-iops: Para cargas de trabajo más exigentes (100 GB - 6000 IOPS)
   • ibmc-vpc-file-metro-1000-iops: Para implementaciones multizona

3. Edita el mapa de configuración del controlador CSI del archivo VPC.

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

4. Establece el campo « SET_DEFAULT_STORAGE_CLASS » en la clase de almacenamiento que hayas elegido.

   data:
     SET_DEFAULT_STORAGE_CLASS: "ibmc-vpc-file-metro-1000-iops"
   

5. Guarde y salga del editor.

6. Espera unos minutos a que los cambios surtan efecto.

7. Comprueba la clase de almacenamiento predeterminada.

   oc get storageclass | grep "(default)"
   

Paso 4: Configurar perfiles de almacenamiento para la VPC File Storage

Tras instalar el Operador de virtualización de OpenShift, debes configurar perfiles de almacenamiento para los discos de contenedor de VPC ( File Storage ), ya que el Importador de discos de contenedor (CDI) no reconoce automáticamente las propiedades de los discos de contenedor de VPC ( File Storage ).

Este paso debe completarse tras instalar el Operador de virtualización de OpenShift.

for sp in $(oc get storageprofile.cdi.kubevirt.io -o json | jq -r '.items[] | select(.status.provisioner == "vpc.file.csi.ibm.io") | .metadata.name'); do
  oc patch storageprofile.cdi.kubevirt.io "$sp" --type=merge -p '{
    "spec": {
      "claimPropertySets": [
        {
          "accessModes": ["ReadWriteMany"],
          "volumeMode": "Filesystem"
        }
      ]
    }
  }'
done

Comprobación de la instalación de VPC en File Storage

1. Comprueba que los pods del controlador CSI del archivo VPC estén en ejecución.

   oc get pods -n kube-system | grep vpc-file
   

2. Comprueba que la clase de almacenamiento predeterminada esté configurada correctamente.

   oc get storageclass | grep "(default)"
   

3. Prueba la asignación de almacenamiento creando un PVC de prueba.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: test-pvc
   spec:
     accessModes:
     - ReadWriteMany
     resources:
       requests:
         storage: 10Gi
   

4. Comprueba que el PVC esté bien fijado.

   oc get pvc test-pvc
   

5. Elimina el PVC de prueba.

   oc delete pvc test-pvc
   

Falla la instalación de ODF

Si la instalación de ODF falla, compruebe lo siguiente:

• Comprueba que tus nodos bare metal disponen de almacenamiento local NVME
• Asegúrate de tener al menos 3 nodos de trabajo
• Compruebe que los discos están desmontados y sin formato
• Revise los registros del operador ODF: oc logs -n openshift-storage -l app=ocs-operator

VPC File Storage: los PVC siguen pendientes

Si las PVC permanecen en estado pendiente:

• Comprueba que el complemento del controlador CSI del archivo VPC esté instalado y funcione correctamente
• Comprueba que la clase de almacenamiento predeterminada esté configurada correctamente
• Asegúrate de que los perfiles de almacenamiento estén configurados con el modo de acceso RWX
• Revisar los registros del controlador CSI: oc logs -n kube-system -l app=ibm-vpc-file-csi-controller

Los perfiles de almacenamiento no se han actualizado

Si los perfiles de almacenamiento no muestran la configuración correcta:

• Asegúrate de que el operador de virtualización de OpenShift esté instalado
• Espera a que se creen automáticamente los perfiles de almacenamiento
• Modifica manualmente los perfiles de almacenamiento mediante los comandos proporcionados
• Comprueba que el nombre del proveedor coincida vpc.file.csi.ibm.io