OpenShift Data Foundation の更新

EUS アップグレードのワークフローの例:

1. ワーカーマシンプールを一時停止します。
2. OpenShift <4.y> → OpenShift <4.y+1> を更新します。
3. OpenShift Data Foundation <4.y> → OpenShift Data Foundation <4.y+1> を更新します。
4. OpenShift <4.y+1> → OpenShift <4.y+2> を更新します。
5. OpenShift Data Foundation <4.y+2> に更新します。
6. ワーカーマシンプールの一時停止を解除します。

1. OpenShift Container Platform の クラスターの更新 ドキュメントに従って OpenShift Container Platform を更新します。

2. Red Hat OpenShift Data Foundation を更新します。

   1. 更新に非接続環境を準備する には、Operator Lifecycle Manager を制限されたネットワークで使用するための Operator ガイドを参照し、OpenShift Data Foundation およびローカルストレージ Operator を使用している場合はこれらを更新できるようにします。
   2. マイナーリリース間の更新 は、Red Hat OpenShift Data Foundation 4.15 から 4.16 への更新 を参照してください。
   3. z-stream リリース間の更新 は、Red Hat OpenShift Data Foundation 4.16.x の 4.16.y への更新 を参照してください。
   4. 外部モードのデプロイメントを更新する場合は、Red Hat OpenShift Data Foundation 外部シークレットの更新 のセクションにある手順も実行する必要があります。
   5. ローカルストレージを使用する場合は、Local Storage Operator を更新します。不明な場合は、Local Storage Operator デプロイメントの確認 を参照してください。

手順

1. OpenShift Web コンソールで、Operators → Installed Operators に移動します。
2. openshift-storage プロジェクトを選択します。
3. OpenShift Data Foundation Operator 名をクリックします。
4. Subscription タブをクリックしてから、Update Channel の下にあるリンクをクリックします。
5. stable-4.15 更新チャネルを選択して、Save をクリックします。

6. Upgrade status に requires approval が表示される場合は、requires approval をクリックします。

   1. Install Plan Details ページで、Preview Install Plan をクリックします。

   2. インストール計画を確認し、Approve をクリックします。

      Status が Unknown から Created に変更されるまで待機します。

7. Operators → Installed Operators に移動します。

8. openshift-storage プロジェクトを選択します。

   OpenShift Data Foundation Operator の Status が Up to date に変わるのを待ちます。

9. Operator が正常にアップグレードされると、Web console update is available メッセージを含むポップアップがユーザーインターフェイスに表示されます。このポップアップから Refresh web console をクリックして、反映するコンソールを変更します。

手順

1. OpenShift Web コンソールで、Operators → Installed Operators に移動します。

2. openshift-storage プロジェクトを選択します。

   注記

   Show default projects オプションが無効になっている場合は、切り替えボタンを使用して、すべてのデフォルトプロジェクトをリスト表示します。

3. OpenShift Data Foundation Operator 名をクリックします。
4. Subscription タブをクリックします。
5. Upgrade Status に require approval が表示される場合は、requires approval リンクをクリックします。
6. InstallPlan Details ページで、Preview Install Plan をクリックします。
7. インストール計画を確認し、Approve をクリックします。
8. Status が Unknown から Created に変更されるまで待機します。
9. Operator が正常にアップグレードされると、Web console update is available メッセージを含むポップアップがユーザーインターフェイスに表示されます。このポップアップから Refresh web console をクリックして、反映するコンソールを変更します。

手順

1. Operators → Installed Operators に移動します。

2. Project ドロップダウンリストから openshift-storage を選択します。

   注記

   Show default projects オプションが無効になっている場合は、切り替えボタンを使用して、すべてのデフォルトプロジェクトをリスト表示します。

3. OpenShift Data Foundation Operator 名をクリックします。
4. Subscription タブに移動します。
5. Update approval を変更するには、鉛筆 アイコンをクリックします。
6. 更新承認ストラテジーを選択し、Save をクリックします。

手順

1. ceph-external-cluster-details-exporter.py Python スクリプトの OpenShift Data Foundation バージョンをダウンロードします。

   # oc get csv $(oc get csv -n openshift-storage | grep ocs-operator | awk '{print $1}') -n openshift-storage -o jsonpath='{.metadata.annotations.external\.features\.ocs\.openshift\.io/export-script}' | base64 --decode > ceph-external-cluster-details-exporter.py

2. 更新パーミッションは、外部の Red Hat Ceph Storage クラスターのクライアントノードで ceph-external-cluster-details-exporter.py を実行して、外部の Red Hat Ceph Storage クラスターを制限します。これを行うには、Red Hat Ceph Storage の管理者への問い合わせが必要になる場合があります。

   # python3 ceph-external-cluster-details-exporter.py --upgrade

   更新後のユーザーパーミッションは以下のように設定されます。

   client.csi-cephfs-node
   key: AQCYz0piYgu/IRAAipji4C8+Lfymu9vOrox3zQ==
   caps: [mds] allow rw
   caps: [mgr] allow rw
   caps: [mon] allow r, allow command 'osd blocklist'
   caps: [osd] allow rw tag cephfs =
   client.csi-cephfs-provisioner
   key: AQCYz0piDUMSIxAARuGUyhLXFO9u4zQeRG65pQ==
   caps: [mgr] allow rw
   caps: [mon] allow r, allow command 'osd blocklist'
   caps: [osd] allow rw tag cephfs metadata=*
   client.csi-rbd-node
   key: AQCYz0pi88IKHhAAvzRN4fD90nkb082ldrTaHA==
   caps: [mon] profile rbd, allow command 'osd blocklist'
   caps: [osd] profile rbd
   client.csi-rbd-provisioner
   key: AQCYz0pi6W8IIBAAgRJfrAW7kZfucNdqJqS9dQ==
   caps: [mgr] allow rw
   caps: [mon] profile rbd, allow command 'osd blocklist'
   caps: [osd] profile rbd

3. 以前にダウンロードした Python スクリプトを実行し、外部の Red Hat Ceph Storage クラスターから生成された JSON 出力を保存します。

   1. 以前にダウンロードした Python スクリプトを実行します。

      注記
      • 使用したオプションの引数も含め、元のデプロイメントで使用したすべてのフラグを必ず使用してください。
      • monitoring-endpoint および monitoring-endpoint-port を除くオプション引数を含むすべてのパラメーターが、外部モードでの OpenShift Data Foundation のデプロイメント時に使用したパラメーターと同じであることを確認します。

      # python3 ceph-external-cluster-details-exporter.py --rbd-data-pool-name <rbd block pool name> --monitoring-endpoint <ceph mgr prometheus exporter endpoint> --monitoring-endpoint-port <ceph mgr prometheus exporter port> --rgw-endpoint <rgw endpoint> --run-as-user <ocs_client_name>  [optional arguments]

      --rbd-data-pool-name

      OpenShift Data Foundation でブロックストレージを提供するために使用される必須のパラメーターです。

      --rgw-endpoint

      オプション。OpenShift Data Foundation の Ceph Rados Gateway でオブジェクトストレージをプロビジョニングする場合に、このパラメーターを指定します。<ip_address>:<port> の形式でエンドポイントを指定します。

      --monitoring-endpoint

      オプション。OpenShift Container Platform クラスターから到達可能な、アクティブ mgr およびスタンバイ mgr の IP アドレスのコンマ区切りリストを受け入れます。指定しないと、値が自動的に入力されます。

      --monitoring-endpoint-port

      オプション。--monitoring-endpoint で指定された ceph-mgr Prometheus エクスポーターに関連付けられるポートです。指定しないと、値が自動的に入力されます。

      --run-as-user

      OpenShift Data Foundation クラスターのデプロイメント時に使用されるクライアント名。別のクライアント名が設定されていない場合は、デフォルトのクライアント名 client.healthchecker を使用します。

      その他のフラグ:

      rgw-pool-prefix	(オプション) RGW プールの接頭辞。指定しない場合、デフォルトの接頭辞は default になります。
      rgw-tls-cert-path	(オプション) RADOS Gateway エンドポイント TLS 証明書のファイルパス。
      rgw-skip-tls	(オプション) このパラメーターは、自己署名証明書が提供される場合、TLS 証明書検証を無視します (非推奨)。
      ceph-conf	(オプション) Ceph 設定ファイルの名前。
      cluster-name	(オプション) Ceph クラスター名。
      出力 (output)	(オプション) 出力の保存が必要なファイル。
      cephfs-metadata-pool-name	(オプション) CephFS メタデータプールの名前。
      cephfs-data-pool-name	(オプション) CephFS データプールの名前。
      cephfs-filesystem-name	(オプション) CephFS ファイルシステムの名前。
      rbd-metadata-ec-pool-name	(オプション) イレイジャーコードの RBD メタデータプールの名前。
      dry-run	(オプション) このパラメーターは、実行されたコマンドを実行せずに出力する際に役立ちます。

   2. 前の手順でスクリプトを実行した後に生成された JSON 出力を保存します。

      出力例:

      [{"name": "rook-ceph-mon-endpoints", "kind": "ConfigMap", "data": {"data": "xxx.xxx.xxx.xxx:xxxx", "maxMonId": "0", "mapping": "{}"}}, {"name": "rook-ceph-mon", "kind": "Secret", "data": {"admin-secret": "admin-secret", "fsid": "<fs-id>", "mon-secret": "mon-secret"}}, {"name": "rook-ceph-operator-creds", "kind": "Secret", "data": {"userID": "<user-id>", "userKey": "<user-key>"}}, {"name": "rook-csi-rbd-node", "kind": "Secret", "data": {"userID": "csi-rbd-node", "userKey": "<user-key>"}}, {"name": "ceph-rbd", "kind": "StorageClass", "data": {"pool": "<pool>"}}, {"name": "monitoring-endpoint", "kind": "CephCluster", "data": {"MonitoringEndpoint": "xxx.xxx.xxx.xxxx", "MonitoringPort": "xxxx"}}, {"name": "rook-ceph-dashboard-link", "kind": "Secret", "data": {"userID": "ceph-dashboard-link", "userKey": "<user-key>"}}, {"name": "rook-csi-rbd-provisioner", "kind": "Secret", "data": {"userID": "csi-rbd-provisioner", "userKey": "<user-key>"}}, {"name": "rook-csi-cephfs-provisioner", "kind": "Secret", "data": {"adminID": "csi-cephfs-provisioner", "adminKey": "<admin-key>"}}, {"name": "rook-csi-cephfs-node", "kind": "Secret", "data": {"adminID": "csi-cephfs-node", "adminKey": "<admin-key>"}}, {"name": "cephfs", "kind": "StorageClass", "data": {"fsName": "cephfs", "pool": "cephfs_data"}}, {"name": "ceph-rgw", "kind": "StorageClass", "data": {"endpoint": "xxx.xxx.xxx.xxxx", "poolPrefix": "default"}}, {"name": "rgw-admin-ops-user", "kind": "Secret", "data": {"accessKey": "<access-key>", "secretKey": "<secret-key>"}}]

4. 生成された JSON ファイルをアップロードします。

   1. OpenShift Web コンソールにログインします。
   2. Workloads → Secrets をクリックします。
   3. プロジェクトを openshift-storage に設定します。
   4. rook-ceph-external-cluster-details をクリックします。
   5. Actions (⋮) → Edit Secret をクリックします。
   6. Browse をクリックして JSON ファイルをアップロードします。
   7. Save をクリックします。