3.7. マルチアーキテクチャーのコンピュートマシンを備えたクラスターへの移行

手順

1. 以下のコマンドを実行して、Cluster Version Operator (CVO) で RetrievedUpdates 条件が True になっていることを確認します。

   $ oc get clusterversion/version -o=jsonpath="{.status.conditions[?(.type=='RetrievedUpdates')].status}"

   Copy to Clipboard Toggle word wrap

   RetrievedUpates 条件が False の場合、以下のコマンドを使用して障害に関する補足情報を見つけることができます。

   $ oc adm upgrade

   Copy to Clipboard Toggle word wrap

   クラスターバージョンの条件タイプに関する詳細は、クラスターバージョンの条件タイプについて を参照してください。

2. RetrievedUpdates 条件が False の場合は、次のコマンドを実行してチャネルを stable-<4.y> または fast-<4.y> に変更します。

   $ oc adm upgrade channel <channel>

   Copy to Clipboard Toggle word wrap

   チャネルを設定したら、RetrievedUpdates が True になっているか確認します。

   チャネルの詳細は、更新チャネルとリリースについて を参照してください。

3. 以下のコマンドを実行して、マルチアーキテクチャーペイロードに移行します。

   $ oc adm upgrade --to-multi-arch

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、コントロールプレーンノードのアーキテクチャーを確認します。

   $ oc get nodes -o wide

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                          STATUS   ROLES                  AGE    VERSION   INTERNAL-IP EXTERNAL-IP   OS-IMAGE                                         KERNEL-VERSION                 CONTAINER-RUNTIME
   worker-001.example.com        Ready    worker                 100d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   worker-002.example.com        Ready    worker                 98d    v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   worker-003.example.com        Ready    worker                 98d    v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   master-001.example.com        Ready    control-plane,master   120d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   master-002.example.com        Ready    control-plane,master   120d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   master-003.example.com        Ready    control-plane,master   120d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x

   Copy to Clipboard Toggle word wrap

   出力の KERNEL-VERSION フィールドは、ノードのアーキテクチャーを示します。

2. 次のコマンドを実行して、クラスターがマルチペイロードを使用していることを確認します。

   $ oc adm release info -o jsonpath="{ .metadata.metadata}"

   Copy to Clipboard Toggle word wrap

   次の出力が表示された場合、クラスターはマルチアーキテクチャーと互換性があります。

   {
    "release.openshift.io/architecture": "multi",
    "url": "https://access.redhat.com/errata/<errata_version>"
   }

   Copy to Clipboard Toggle word wrap

   クラスターがマルチペイロードを使用していない場合は、クラスターをマルチアーキテクチャークラスターに移行します。詳細は、「マルチアーキテクチャーのコンピュートマシンを備えたクラスターへの移行」を参照してください。

3. 次のコマンドを実行して、イメージストリームをシングルアーキテクチャーからマルチアーキテクチャーに更新します。

   $ oc import-image <multiarch_image_stream_tag>  --from=<registry>/<project_name>/<image_name> \
   --import-mode='PreserveOriginal'

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを実行して、コントロールプレーンマシンセットを設定するための arm64 互換の Amazon Machine Image (AMI) を取得します。

   $ oc get configmap/coreos-bootimages -n openshift-machine-config-operator -o jsonpath='{.data.stream}' | jq -r '.architectures.aarch64.images.aws.regions."<aws_region>".image' 

   1

   Copy to Clipboard Toggle word wrap

   1

   <aws_region> は、現在のクラスターがインストールされている AWS リージョンに置き換えます。次のコマンドを実行すると、インストールされているクラスターの AWS リージョンを取得できます。

   $ oc get infrastructure cluster -o jsonpath='{.status.platformStatus.aws.region}'

   Copy to Clipboard Toggle word wrap

   出力例

   ami-xxxxxxx

   Copy to Clipboard Toggle word wrap

5. 次のコマンドを実行して、arm64 アーキテクチャーをサポートするために、コントロールプレーンマシンセットを更新します。

   $ oc edit controlplanemachineset.machine.openshift.io cluster -n openshift-machine-api

   Copy to Clipboard Toggle word wrap

   instanceType フィールドを arm64 アーキテクチャーをサポートするタイプに更新します。ami.id フィールドを arm64 アーキテクチャーと互換性のある AMI に設定します。サポートされているインスタンスタイプの詳細は、「64 ビット ARM インフラストラクチャー上の AWS のテスト済みインスタンスタイプ」を参照してください。

   AWS のコントロールプレーンマシンセットの設定の詳細は、「Amazon Web Services のコントロールプレーン設定オプション」を参照してください。

手順

1. 次のコマンドを実行して、コントロールプレーンまたはインフラノードのアーキテクチャーを確認します。

   $ oc get nodes -o wide

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                          STATUS   ROLES                  AGE    VERSION   INTERNAL-IP EXTERNAL-IP   OS-IMAGE                                         KERNEL-VERSION                 CONTAINER-RUNTIME
   worker-001.example.com        Ready    infra                 100d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   master-001.example.com        Ready    control-plane,master   120d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x

   Copy to Clipboard Toggle word wrap

   出力の KERNEL-VERSION フィールドは、ノードのアーキテクチャーを示します。

2. 次のコマンドを実行して、クラスターがマルチペイロードを使用していることを確認します。

   $ oc adm release info -o jsonpath="{ .metadata.metadata}"

   Copy to Clipboard Toggle word wrap

   次の出力が表示された場合、クラスターはマルチアーキテクチャーと互換性があります。

   {
    "release.openshift.io/architecture": "multi",
    "url": "https://access.redhat.com/errata/<errata_version>"
   }

   Copy to Clipboard Toggle word wrap

   クラスターがマルチペイロードを使用していない場合は、クラスターをマルチアーキテクチャークラスターに移行します。詳細は、「マルチアーキテクチャーのコンピュートマシンを備えたクラスターへの移行」を参照してください。

3. カスタムイメージストリームを使用する場合は、イメージストリームごとに次のコマンドを実行して、シングルアーキテクチャーからマルチアーキテクチャーに更新します。

   $ oc import-image <multiarch_image_stream_tag>  --from=<registry>/<project_name>/<image_name> \
   --import-mode='PreserveOriginal'

   Copy to Clipboard Toggle word wrap
4. コンピュートエンジンの General-purpose machine family から、ターゲットアーキテクチャーに一致するインスタンスタイプ(Google ドキュメント)を選択します。Available regions and zones テーブル(Google ドキュメント)を確認し、ゾーンでインスタンスタイプがサポートされていることを確認します。
5. General-purpose machine family for Compute engine (Google ドキュメント)の「Supported disk types」セクションで選択したインスタンスタイプに対して、サポートされているディスクタイプを選択します。

6. 次のコマンドを実行して、移行後にマシンセットが使用する Google Cloud イメージを確認します。

   $ oc get configmap/coreos-bootimages \
     -n openshift-machine-config-operator \
     -o jsonpath='{.data.stream}' | jq \
     -r '.architectures.aarch64.images.gcp'

   Copy to Clipboard Toggle word wrap

   出力例

   "gcp": {
       "release": "415.92.202309142014-0",
       "project": "rhcos-cloud",
       "name": "rhcos-415-92-202309142014-0-gcp-aarch64"
     }

   Copy to Clipboard Toggle word wrap

   出力の project および name パラメーターを使用して、projects/<project>/global/images/<name> の形式で image パラメーターを形成します。

7. コントロールプレーンを別のアーキテクチャーに移行するには、以下のコマンドを実行します。

   $ oc edit controlplanemachineset.machine.openshift.io cluster -n openshift-machine-api

   Copy to Clipboard Toggle word wrap
   1. disks.type パラメーターを、選択したディスクタイプに置き換えます。
   2. disks.image パラメーターは、以前に作成された image パラメーターに置き換えます。
   3. machineType パラメーターを、選択したインスタンスタイプに置き換えます。

8. infra マシンセットを別のアーキテクチャーに移行するには、infra マシンセットの ID を使用して以下のコマンドを実行します。

   $ oc edit machineset <infra-machine-set_id> -n openshift-machine-api

   Copy to Clipboard Toggle word wrap
   1. disks.type パラメーターを、選択したディスクタイプに置き換えます。
   2. disks.image パラメーターは、以前に作成された image パラメーターに置き換えます。
   3. machineType パラメーターを、選択したインスタンスタイプに置き換えます。