選用項目: 設定 IBM Cloud Object Storage 服務實例

如果您想要將 IBM Cloud Object Storage 設定為儲存空間叢集中的預設後端儲存庫，請建立 IBM Cloud Object Storage的實例。 然後，建立一組 HMAC 認證及使用 Object Storage HMAC 認證的 Kubernetes 密鑰。 如果您在安裝期間未指定 IBM Cloud Object Storage 認證，則會使用叢集裡的 PV 來建立儲存體叢集中的預設後端儲存庫。 您可以在部署 ODF 之後設定其他後端儲存庫，但無法變更預設後端儲存庫。

存取您的 Red Hat OpenShift 叢集。

1. 在叢集裡建立 openshift-storage 名稱空間。 驅動程式 Pod 會部署至此名稱空間。 複製下列 YAML，並將它儲存為本端機器上的 os-namespace.yaml。

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

2. 使用您儲存的 YAML 檔案來建立 openshift-storage 名稱空間。

   oc create -f os-namespace.yaml
   

3. 請確認命名空間已建立。

   oc get namespaces | grep storage
   

4. 建立 IBM Cloud Object Storage 服務實例。

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

5. 建立 HMAC 認證。 請記下您的認證。

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

6. 在使用 Object Storage HMAC 認證的 openshift-storage 名稱空間中建立名為 ibm-cloud-cos-creds 的 Kubernetes 密鑰。 當您執行指令時，請指定 Object Storage HMAC 存取金鑰 ID 及秘密存取金鑰。 請注意，您的密鑰必須命名為 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. 請確認您的密鑰已建立。

   oc get secrets -A | grep cos
   

選用項目: 使用 Hyper Protect Crypto Services 設定加密

如果您想要設定加密，請建立 Hyper Protect Crypto Services 或 Key Protect的實例。 然後，建立根金鑰及使用 Hyper Protect Crypto Services 或 Key Protect 認證的 Kubernetes 密鑰。

IBM Cloud 正在將專用金鑰管理服務從 Hyper Protect Crypto Services 變更為 Key Protect 專用。

Hyper Protect Crypto Services 或 Key Protect 的 API 金鑰必須具有下列最低必要許可權:

Reader

Reader Plus

如果您使用叢集層面加密及儲存空間類別加密，則 API 金鑰必須具有下列必要許可權:

Reader

Reader Plus

Writer

1. 建立 Hyper Protect Crypto Services 或 Key Protect 服務實例。

2. 建立根金鑰

   • Hyper Protect Crypto Services.
   • Key Protect.

3. 建立實例及根金鑰之後，請記下 Hyper Protect Crypto Services 或 Key Protect 實例名稱、實例 ID、根金鑰 ID 及公開端點。

4. 建立 服務 ID、API 金鑰 及 存取原則，容許存取 Hyper Protect Crypto Services 及 Red Hat OpenShift on IBM Cloud 或 Key Protect 及 Red Hat OpenShift on IBM Cloud。 請將您所建立的 API 記錄下來。

存取您的 Red Hat OpenShift 叢集。

1. 列出名稱空間，以判定您是否具有 openshift-storage 名稱空間。 如果您沒有 openshift-storage 名稱空間，請建立它。

   oc get namespaces | grep openshift-storage
   

   1. 在叢集裡建立 openshift-storage 名稱空間。 驅動程式 Pod 會部署至此名稱空間。 複製下列 YAML，並將它儲存為本端機器上的 os-namespace.yaml。

       apiVersion: v1
       kind: Namespace
       metadata:
         labels:
           openshift.io/cluster-monitoring: "true"
         name: openshift-storage
       ```
   1. 使用您儲存的 YAML 檔案來建立 `openshift-storage` 名稱空間。
   ```sh {: pre}
       oc create -f os-namespace.yaml
       ```
   1. 請確認命名空間已建立。
   ```sh {: pre}
       oc get namespaces | grep storage
       ```
   

2. 將根金鑰的 ID 及您建立的服務 ID 的 API 金鑰編碼為 base64。

   printf "ROOT-KEY-ID" | base64
   

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

3. 在使用 Hyper Protect Crypto Services 認證的 openshift-storage 名稱空間中建立 Kubernetes 密鑰。
   1. 將下列密鑰儲存為稱為 ibm-hpcs-secret.yaml 的 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. 在叢集裡建立密碼。
   ```sh {: pre}
       oc apply -f ibm-hpcs-secret.yaml
       ```
   

4. 請確認您的密鑰已建立。

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

準備叢集以進行 OpenShift Data Foundation 安裝

在您安裝 OpenShift Data Foundation 之前，請準備您的群集。

存取您的 Red Hat OpenShift 叢集。

1. 使用 oc debug 指令登入叢集裡的每一個工作者節點，並完成下列步驟。

   • 登入工作節點。 請將 <worker_node_IP> 替換為您的工作節點名稱。 若要取得工作者節點的名稱，請執行 oc get nodes 指令。

       oc debug node/<node name> -- chroot /host rm -rvf /var/lib/rook /mnt/local-storage
       ```
   - 針對每一個磁碟分割區，清除工作者節點上的 `xfs` 檔案系統。 如果您未清除檔案系統，則不會建立 OSD。
   ```sh {: pre}
       file -sL /dev/<partition>
       wipefs -a /dev/<partition>
       ```
   - 編輯 `/etc/kubernetes/kubelet.conf` 檔案，並將 `EnableControllerAttachDetach` 參數的值變更為 `true`。
   ```sh {: pre}
       nano /etc/kubernetes/kubelet.conf
       ```
   - 請使用 ` `ctrl + X`` 來儲存並退出。
   
   - 重新啟動 kubelet。
   ```sh {: pre}
       systemctl restart kubelet
       ```
   - 登出工作者節點。
   ```sh
       exit
       ```
   
   

2. 針對您要在 ODF 部署中使用的每一個工作者節點，重複先前的步驟來清除檔案系統。

取得裝置詳細資料

您可以使用自動磁碟探索來尋找 ODF 的可用裝置。 不過，如果您想要手動指定 ODF 的儲存裝置，請完成下列步驟來擷取儲存裝置詳細資料。

在安裝 ODF 之前，請取得工作者節點上本端磁碟的詳細資料。

1. 登入叢集，並取得可用工作者節點的清單。 記下您要在 OCS 部署中使用的工作者節點。

   oc get nodes
   

2. 登入您要用於 ODF 的每一個工作者節點。

   oc debug node/<node-name>
   

3. 在工作者節點上部署除錯 Pod 之後，請執行下列指令以容許主機二進位檔。

   chroot /host
   

4. 列出工作者節點上的可用磁碟。

   lsblk
   

5. 檢閱可用磁碟的指令輸出。 您只能將未裝載的磁碟用於 ODF 部署，例如下列範例中的 sdc 磁碟。 請注意，ODF 部署的起始儲存體容量等於您指定為 osd-device-path 的磁碟大小。 在此範例中，sdc 磁碟已卸載，且有兩個可用的分割區: sdc1 和 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. 針對您要在部署中使用的每一個未裝載磁碟，尋找磁碟 ID。 在下列範例中，sdc1 分割區的 ID 是 scsi-3600605b00d87b43027b3bc310a64c6c9-part1，而 sdc2 分割區的 ID 是 scsi-3600605b00d87b43027b3bc310a64c6c9-part2。

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

   輸出範例

   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. 針對您要用於 OpenShift Data Foundation 部署的每一個工作者節點，重複先前的步驟。

8. 在叢集裡安裝 ODF。