Facoltativo: configurazione di una istanza del servizio IBM Cloud Object Storage

Se vuoi configurare IBM Cloud Object Storage come archivio di backup predefinito nel tuo cluster di archiviazione, crea un'istanza di IBM Cloud Object Storage. Crea quindi una serie di credenziali HMAC e un segreto Kubernetes che utilizza le credenziali HMAC Object Storage. Se non specifichi le credenziali IBM Cloud Object Storage durante l'installazione, l'archivio di backup predefinito nel tuo cluster di archiviazione viene creato utilizzando i PV nel tuo cluster. È possibile configurare ulteriori archivi di backup dopo la distribuzione di ODF, ma non è possibile modificare l'archivio di backup predefinito.

Accedi al tuo cluster Red Hat OpenShift.

1. Creare uno spazio dei nomi openshift-storage nel cluster. I pod del driver vengono distribuiti in questo namespace. Copiare il seguente YAML e salvarlo come os-namespace.yaml sulla macchina locale.

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

2. Crea lo spazio dei nomi openshift-storage utilizzando il file YAML che hai salvato.

   oc create -f os-namespace.yaml
   

3. Verificare che lo spazio dei nomi sia stato creato.

   oc get namespaces | grep storage
   

4. Crea un'istanza del servizio IBM Cloud Object Storage.

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

5. Creare credenziali HMAC. Prendi nota delle credenziali.

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

6. Crea il segreto Kubernetes denominato ibm-cloud-cos-creds nello spazio dei nomi openshift-storage che utilizza le tue credenziali HMAC Object Storage. Quando esegui il comando, specifica il tuo ID chiave di accesso HMAC Object Storage e la chiave di accesso segreta. Nota che il tuo segreto deve essere denominato 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. Verifica che il tuo segreto sia stato creato.

   oc get secrets -A | grep cos
   

Facoltativo: configurazione della crittografia utilizzando Hyper Protect Crypto Services

Se vuoi configurare la crittografia, crea un'istanza di Hyper Protect Crypto Services o Key Protect. Quindi, crea una chiave root e un segreto Kubernetes che utilizza le tue credenziali Hyper Protect Crypto Services o Key Protect.

IBM Cloud sta modificando i servizi dedicati alla gestione delle chiavi da Hyper Protect Crypto Services a Key Protect dedicati.

La tua chiave API per Hyper Protect Crypto Services o Key Protect deve avere le seguenti autorizzazioni minime richieste:

Reader

Reader Plus

Se stai utilizzando la crittografia a livello di cluster e la crittografia della classe di archiviazione, la tua chiave API deve disporre delle seguenti autorizzazioni richieste:

Reader

Reader Plus

Writer

1. Crea un'istanza del servizio Hyper Protect Crypto Services o Key Protect.

2. Crea chiave root

   • Hyper Protect Crypto Services.
   • Key Protect.

3. Dopo aver creato la tua istanza e la tua chiave root, prendi nota del nome della tua istanza Hyper Protect Crypto Services o Key Protect, dell'ID istanza, dell'ID chiave root e dell'endpoint pubblico.

4. Crea un ID servizio, chiave API e politica di accesso che consente l'accesso a Hyper Protect Crypto Services e Red Hat OpenShift on IBM Cloud o Key Protect e Red Hat OpenShift on IBM Cloud. Prendi nota dell'API che crei.

Accedi al tuo cluster Red Hat OpenShift.

1. Elencare gli spazi dei nomi per stabilire se si dispone di uno spazio dei nomi openshift-storage. Se non hai uno spazio dei nomi openshift-storage, crealo.

   oc get namespaces | grep openshift-storage
   

   1. Creare uno spazio dei nomi openshift-storage nel cluster. I pod del driver vengono distribuiti in questo namespace. Copiare il seguente YAML e salvarlo come os-namespace.yaml sulla macchina locale.

       apiVersion: v1
       kind: Namespace
       metadata:
         labels:
           openshift.io/cluster-monitoring: "true"
         name: openshift-storage
       ```
   1. Crea lo spazio dei nomi `openshift-storage` utilizzando il file YAML che hai salvato.
   ```sh {: pre}
       oc create -f os-namespace.yaml
       ```
   1. Verificare che lo spazio dei nomi sia stato creato.
   ```sh {: pre}
       oc get namespaces | grep storage
       ```
   

2. Codifica sia l'ID della tua chiave root che la chiave API del servizio che hai creato per base64.

   printf "ROOT-KEY-ID" | base64
   

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

3. Crea il segreto Kubernetes nel namespace openshift-storage che utilizza le credenziali Hyper Protect Crypto Services.
   1. Salva il seguente segreto come file YAML denominato 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. Crea il segreto nel tuo cluster.
   ```sh {: pre}
       oc apply -f ibm-hpcs-secret.yaml
       ```
   

4. Verifica che il tuo segreto sia stato creato.

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

Preparazione del tuo cluster per una installazione di OpenShift Data Foundation

Prima di installare OpenShift Data Foundation, preparare il cluster.

Accedi al tuo cluster Red Hat OpenShift.

1. Accedi a ciascun nodo di lavoro nel tuo cluster utilizzando il comando oc debug e completa la seguente procedura.

   • Accedi al nodo di lavoro. Sostituisci " <worker_node_IP> " con il nome del tuo nodo di lavoro. Per ottenere nomi dei tuoi nodi di lavoro, esegui il comando oc get nodes.

       oc debug node/<node name> -- chroot /host rm -rvf /var/lib/rook /mnt/local-storage
       ```
   - Per ogni partizione disco, cancellare il file system `xfs` sul nodo di lavoro. Se non si cancella il file system, l'OSD non viene creato.
   ```sh {: pre}
       file -sL /dev/<partition>
       wipefs -a /dev/<partition>
       ```
   - Modificare il file `/etc/kubernetes/kubelet.conf` e modificare il valore del parametro `EnableControllerAttachDetach` in `true`.
   ```sh {: pre}
       nano /etc/kubernetes/kubelet.conf
       ```
   - Salva e chiudi utilizzando il comando “ `ctrl + X` ”.
   
   - Riavviare il kubelet.
   ```sh {: pre}
       systemctl restart kubelet
       ```
   - Scollegarsi dal nodo di lavoro.
   ```sh
       exit
       ```
   
   

2. Ripetere i passaggi precedenti per cancellare il file system per ogni nodo di lavoro che si desidera utilizzare nella distribuzione ODF.

Come ottenere i dettagli del proprio dispositivo

È possibile utilizzare il rilevamento disco automatico per trovare le periferiche disponibili per ODF. Tuttavia, se si desidera specificare manualmente le periferiche di archiviazione per ODF, completare la seguente procedura per richiamare i dettagli della periferica di archiviazione.

Prima di installare ODF, ottenere i dettagli dei dischi locali sui nodi di lavoro.

1. Accedi al tuo cluster e ottieni un elenco di nodi di lavoro disponibili. Prendere nota dei nodi di lavoro che si desidera utilizzare nella distribuzione OCS.

   oc get nodes
   

2. Accedere a ciascun nodo di lavoro che si desidera utilizzare per l'ODF.

   oc debug node/<node-name>
   

3. Dopo aver distribuito il pod di debug sul nodo di lavoro, immetti il seguente comando per consentire i binari host.

   chroot /host
   

4. Elenca i dischi disponibili sul nodo di lavoro.

   lsblk
   

5. Esaminare l'emissione del comando per i dischi disponibili. È possibile utilizzare solo i dischi non montati per le distribuzioni ODF, come i dischi sdc nel seguente esempio. Notare che la capacità di memoria iniziale della distribuzione ODF è uguale alla dimensione del disco specificato come osd-device-path. In questo esempio, il disco sdc è smontato e ha due partizioni disponibili: sdc1 e 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. Per ogni disco smontato che si desidera utilizzare nella distribuzione, individuare l'ID disco. Nel seguente esempio, l'ID per la partizione sdc1 è scsi-3600605b00d87b43027b3bc310a64c6c9-part1 e l'ID per la partizione sdc2 è scsi-3600605b00d87b43027b3bc310a64c6c9-part2.

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

   Output di esempio

   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. Ripeti i passi precedenti per ciascun nodo di lavoro che vuoi utilizzare per la tua distribuzione OpenShift Data Foundation.

8. Installare ODF nel cluster.