Opcional: Configuración de una instancia de servicio de IBM Cloud Object Storage

Si desea configurar IBM Cloud Object Storage como el almacén de copia de seguridad predeterminado en el clúster de almacenamiento, cree una instancia de IBM Cloud Object Storage. A continuación, cree un conjunto de credenciales de HMAC y un secreto de Kubernetes que utilice credenciales de HMAC de Object Storage. Si no especifica credenciales de IBM Cloud Object Storage durante la instalación, el almacén de copia de seguridad predeterminado en el clúster de almacenamiento se crea utilizando las PV del clúster. Puede configurar almacenes de copia de seguridad adicionales después de desplegar ODF, pero no puede cambiar el almacén de copia de seguridad predeterminado.

Acceda al clúster de Red Hat OpenShift.

1. Cree un espacio de nombres openshift-storage en el clúster. Los pods de controlador se despliegan en este espacio de nombres. Copie el siguiente archivo YAML y guárdelo como os-namespace.yaml en la máquina local.

   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       openshift.io/cluster-monitoring: "true"
     name: openshift-storage
   

2. Cree el espacio de nombres openshift-storage utilizando el archivo YAML que ha guardado.

   oc create -f os-namespace.yaml
   

3. Verifique que se ha creado el espacio de nombres.

   oc get namespaces | grep storage
   

4. Cree una instancia de servicio de IBM Cloud Object Storage.

   ibmcloud resource service-instance-create noobaa-store cloud-object-storage standard global
   

5. Cree credenciales de HMAC. Anote las credenciales.

   ibmcloud resource service-key-create cos-cred-rw Writer --instance-name noobaa-store --parameters '{"HMAC": true}'
   

6. Cree el secreto de Kubernetes denominado ibm-cloud-cos-creds en el espacio de nombres openshift-storage que utiliza las credenciales de HMAC de Object Storage. Cuando ejecute el mandato, especifique el ID de clave de acceso de HMAC de Object Storage y la clave de acceso secreta. Tenga en cuenta que el secreto debe denominarse ibm-cloud-cos-creds.

   oc -n 'openshift-storage' create secret generic 'ibm-cloud-cos-creds' --type=Opaque --from-literal=IBM_COS_ACCESS_KEY_ID=<access_key_id> --from-literal=IBM_COS_SECRET_ACCESS_KEY=<secret_access_key>
   

7. Verifique que se ha creado el secreto.

   oc get secrets -A | grep cos
   

Opcional: Configuración del cifrado utilizando Hyper Protect Crypto Services

Si desea configurar el cifrado, cree una instancia de Hyper Protect Crypto Services o Key Protect. A continuación, crea una clave raíz y un secreto de Kubernetes que utilice tus credenciales de Hyper Protect Crypto Services o Key Protect.

IBM Cloud está cambiando los servicios de gestión de claves dedicados de Hyper Protect Crypto Services a Key Protect Dedicated.

La clave de API para Hyper Protect Crypto Services o Key Protect debe tener los permisos mínimos necesarios siguientes:

Reader

Reader Plus

Si está utilizando el cifrado a nivel de clúster y el cifrado de clase de almacenamiento, la clave de API debe tener los siguientes permisos necesarios:

Reader

Reader Plus

Writer

1. Cree una instancia de servicio de Hyper Protect Crypto Services o Key Protect.

2. Crear clave raíz

   • Hyper Protect Crypto Services.
   • Key Protect.

3. Una vez creada la instancia y la clave raíz, anota el nombre de la instancia de Hyper Protect Crypto Services o Key Protect, el ID de la instancia, el ID de la clave raíz y el punto de conexión público.

4. Cree un ID de servicio, clave de API y política de acceso que permita el acceso a Hyper Protect Crypto Services y Red Hat OpenShift on IBM Cloud o Key Protect y Red Hat OpenShift on IBM Cloud. Anote la API que ha creado.

Acceda al clúster de Red Hat OpenShift.

1. Liste los espacios de nombres para determinar si tiene un espacio de nombres de openshift-storage. Si no tiene un espacio de nombres de openshift-storage, créelo.

   oc get namespaces | grep openshift-storage
   

   1. Cree un espacio de nombres openshift-storage en el clúster. Los pods de controlador se despliegan en este espacio de nombres. Copie el siguiente archivo YAML y guárdelo como os-namespace.yaml en la máquina local.

       apiVersion: v1
       kind: Namespace
       metadata:
         labels:
           openshift.io/cluster-monitoring: "true"
         name: openshift-storage
       ```
   1. Cree el espacio de nombres `openshift-storage` utilizando el archivo YAML que ha guardado.
   ```sh {: pre}
       oc create -f os-namespace.yaml
       ```
   1. Verifique que se ha creado el espacio de nombres.
   ```sh {: pre}
       oc get namespaces | grep storage
       ```
   

2. Codifique el ID de la clave raíz y la clave de API del ID de servicio que ha creado en base64.

   printf "ROOT-KEY-ID" | base64
   

   printf "SERVICE-ID-API-KEY" | base64
   

3. Cree el secreto de Kubernetes en el espacio de nombres de openshift-storage que utiliza las credenciales de Hyper Protect Crypto Services.
   1. Guarde el siguiente secreto como un archivo YAML llamado ibm-hpcs-secret.yaml.

       apiVersion: v1
       data:
         IBM_KP_CUSTOMER_ROOT_KEY: AaAAAaZAAAAy11AAAyAAkaAaQtAAk0AAA2AzY5AjYaaa67aa # your base64 encoded root key ID
         IBM_KP_SERVICE_API_KEY: AAAaaajAAAAAncmAAaaaaAAAAdAAId1AtVjBJRU1aAAaAeTh1aEw=AaaaA # your base64 encoded API
       kind: Secret
       metadata:
         name: ibm-hpcs-secret
         namespace: openshift-storage
       type: Opaque
       ```
   1. Cree el secreto en el clúster.
   ```sh {: pre}
       oc apply -f ibm-hpcs-secret.yaml
       ```
   

4. Verifique que se ha creado el secreto.

   oc get secrets -A | grep ibm-hpcs-secret
   

Preparación del clúster para una instalación de OpenShift Data Foundation

Antes de instalar OpenShift Data Foundation, prepare el clúster.

Acceda al clúster de Red Hat OpenShift.

1. Inicie una sesión en cada nodo trabajador del clúster utilizando el mandato oc debug y complete los pasos siguientes.

   • Inicie la sesión en el nodo trabajador. Sustituye por <worker_node_IP> el nombre de tu nodo de trabajo. Para obtener los nombres de tus nodos de trabajo, ejecuta el comando oc get nodes.

       oc debug node/<node name> -- chroot /host rm -rvf /var/lib/rook /mnt/local-storage
       ```
   - Para cada partición de disco, borre el sistema de archivos de `xfs` en el nodo de trabajador. Si no borra el sistema de archivos, no se crea el OSD.
   ```sh {: pre}
       file -sL /dev/<partition>
       wipefs -a /dev/<partition>
       ```
   - Edite el archivo `/etc/kubernetes/kubelet.conf` y cambie el valor del parámetro `EnableControllerAttachDetach` a `true`.
   ```sh {: pre}
       nano /etc/kubernetes/kubelet.conf
       ```
   - Guarde y salga utilizando `ctrl + X`.
   
   - Reinicie el kubelet.
   ```sh {: pre}
       systemctl restart kubelet
       ```
   - Cierre la sesión del nodo de trabajador.
   ```sh
       exit
       ```
   
   

2. Repita los pasos anteriores para borrar el sistema de archivos para cada nodo de trabajador que desee utilizar en el despliegue de ODF.

Cómo obtener los detalles del dispositivo

Puede utilizar el descubrimiento de disco automático para buscar los dispositivos disponibles para ODF. Sin embargo, si desea especificar manualmente dispositivos de almacenamiento para ODF, siga estos pasos para recuperar los detalles del dispositivo de almacenamiento.

Antes de instalar ODF, obtenga los detalles de los discos locales en los nodos trabajadores.

1. Inicie una sesión en el clúster y obtenga una lista de los nodos trabajadores disponibles. Anote los nodos trabajadores que desea utilizar en el despliegue de OCS.

   oc get nodes
   

2. Inicie sesión en cada nodo trabajador que desee utilizar para el ODF.

   oc debug node/<node-name>
   

3. Después de desplegar el pod de depuración en el nodo trabajador, ejecute el mandato siguiente para permitir los binarios de host.

   chroot /host
   

4. Liste los discos disponibles en el nodo trabajador.

   lsblk
   

5. Revise la salida del mandato para los discos disponibles. Sólo puede utilizar discos no montados para despliegues de ODF como, por ejemplo, discos sdc en el ejemplo siguiente. Tenga en cuenta que la capacidad de almacenamiento inicial del despliegue de ODF es igual al tamaño del disco que especifique como osd-device-path. En este ejemplo, el disco sdc está desmontado y tiene dos particiones disponibles: sdc1 y sdc2.

   NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
   sda      8:0    0   931G  0 disk
   |-sda1   8:1    0   256M  0 part /boot
   |-sda2   8:2    0     1G  0 part
    -sda3   8:3    0 929.8G  0 part /
   sdb      8:16   0 744.7G  0 disk
    -sdb1   8:17   0 744.7G  0 part /disk1
   sdc      8:32   0 744.7G  0 disk
   |-sdc1   8:33   0  18.6G  0 part
    -sdc2   8:34   0 260.8G  0 part
   

6. Para cada disco no montado que desea utilizar en el despliegue, busque el ID de disco. En el siguiente ejemplo, el ID para la partición sdc1 es scsi-3600605b00d87b43027b3bc310a64c6c9-part1 y el ID para la partición sdc2 es scsi-3600605b00d87b43027b3bc310a64c6c9-part2.

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

   Salida de ejemplo

   total 0
   lrwxrwxrwx. 1 root root  9 Feb  9 04:15 scsi-3600605b00d87b43027b3bbb603150cc6 -> ../../sda
   lrwxrwxrwx. 1 root root 10 Feb  9 04:15 scsi-3600605b00d87b43027b3bbb603150cc6-part1 -> ../../sda1
   lrwxrwxrwx. 1 root root 10 Feb  9 04:15 scsi-3600605b00d87b43027b3bbb603150cc6-part2 -> ../../sda2
   lrwxrwxrwx. 1 root root 10 Feb  9 04:15 scsi-3600605b00d87b43027b3bbb603150cc6-part3 -> ../../sda3
   lrwxrwxrwx. 1 root root  9 Feb  9 04:15 scsi-3600605b00d87b43027b3bbf306bc28a7 -> ../../sdb
   lrwxrwxrwx. 1 root root 10 Feb  9 04:15 scsi-3600605b00d87b43027b3bbf306bc28a7-part1 -> ../../sdb1
   lrwxrwxrwx. 1 root root  9 Feb  9 04:17 scsi-3600605b00d87b43027b3bc310a64c6c9 -> ../../sdc
   lrwxrwxrwx. 1 root root 10 Feb 11 03:14 scsi-3600605b00d87b43027b3bc310a64c6c9-part1 -> ../../sdc1
   lrwxrwxrwx. 1 root root 10 Feb 11 03:15 scsi-3600605b00d87b43027b3bc310a64c6c9-part2 -> ../../sdc2
   

7. Repita los pasos anteriores para cada nodo trabajador que desee utilizar para el despliegue de OpenShift Data Foundation.

8. Instale ODF en el clúster.