オプション: 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 名前空間を作成します。 ドライバー・ポッドは、この名前空間にデプロイされます。 以下の 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. ibm-cloud-cos-creds 名前空間に、Object Storage HMAC 資格情報を使用する Kubernete シークレットを、openshift-storage という名前で作成します。 このコマンドを実行するときには、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 Dedicatedに変更します。

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. Hyper Protect Crypto Services と Red Hat OpenShift on IBM Cloud または Key Protect と Red Hat OpenShift on IBM Cloudのいずれかへのアクセスを許可する サービス ID、 API キー、および アクセス・ポリシー を作成します。 作成した API をメモします。

Red Hat OpenShift クラスターにアクセスします。

1. 名前空間をリストして、openshift-storage 名前空間があるかどうかを判別します。 openshift-storage 名前空間がない場合は、作成します。

   oc get namespaces | grep openshift-storage
   

   1. クラスター内に openshift-storage 名前空間を作成します。 ドライバー・ポッドは、この名前空間にデプロイされます。 以下の 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 と、base64 に対して作成したサービス ID の API キーの両方をエンコードします。

   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. ワーカー・ノードにデバッグ・ポッドをデプロイした後に、以下のコマンドを実行してホストのバイナリーを許可します。

   chroot /host
   

4. ワーカー・ノードで使用可能なディスクをリスト表示します。

   lsblk
   

5. コマンド出力で使用可能なディスクを確認します。 ODF デプロイメントに使用できるのは、アンマウントされたディスクだけです。例えば、以下の例では sdc のディスクです。 ODF デプロイメントの初期ストレージ容量は、osd-device-path として指定したディスクのサイズと等しくなることに注意してください。 この例では、sdcディスクはアンマウントされ、sdc1とsdc2の 2 つの使用可能なパーティションがあります。

   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 をインストールします。