Red Hat Summit11.6. Cluster API を無効にする
OpenShift Container Platform クラスター上のインフラストラクチャーリソースの管理を自動化するために Cluster API の使用を停止するには、クラスター上の任意の Cluster API リソースを同等の Machine API リソースに変換します。
Cluster API を使用したマシン管理は、テクノロジープレビュー機能のみです。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。
Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。
11.6.1. Cluster API リソースを Machine API リソースに移行する
Machine API と Cluster API リソース間の移行をサポートするクラスターでは、双方向同期コントローラーは Cluster API リソースの Machine API リソースへの変換をサポートします。
双方向同期コントローラーは、TechPreviewNoUpgrade 機能セットの MachineAPIMigration フィーチャーゲートが有効になっているクラスターでのみ動作します。
最初に Machine API から Cluster API に移行したリソース、または最初に Cluster API リソースとして作成したリソースを移行できます。元の Machine API リソースを Cluster API リソースに移行してから、それを元に戻すと、移行プロセスが期待どおりに機能することを確認できます。
一部のリソースは、サポートされているインフラストラクチャータイプでのみ移行できます。
| インフラストラクチャー | コンピュートマシン | コンピュートマシンセット | マシンのヘルスチェック | コントロールプレーンマシンセット | Cluster Autoscaler |
|---|---|---|---|---|---|
| AWS | テクノロジープレビュー | テクノロジープレビュー | 利用不可 | 利用不可 | 利用不可 |
| その他のすべてのインフラストラクチャータイプ | 利用不可 | 利用不可 | 利用不可 | 利用不可 | 利用不可 |
11.6.1.1. Cluster API リソースを移行して Machine API を使用する
個々の Cluster API オブジェクトを同等の Machine API オブジェクトに移行できます。
Cluster API リソースを移行して Machine API を使用する機能は、テクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。
Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。
前提条件
- サポートされているインフラストラクチャータイプに OpenShift Container Platform クラスターをデプロイしている。
-
TechPreviewNoUpgrade機能セットでMachineAPIMigrationフィーチャーゲートを有効化している。 -
cluster-admin権限を持つアカウントを使用してクラスターにアクセスできる。 -
OpenShift CLI (
oc) がインストールされている。
手順
次のコマンドを実行して、Machine API リソースに移行する Cluster API リソースを特定します。
$ oc get <resource_kind> -n openshift-cluster-apiここで、
<resource_kind>は次のいずれかの値になります。machine.cluster.x-k8s.io- コンピュートまたはコントロールプレーンマシンのリソースの種類の完全修飾名。
machineset.cluster.x-k8s.io- コンピュートマシンセットのリソースの種類の完全修飾名。
次のコマンドを実行してリソース仕様を編集します。
$ oc edit <resource_kind>/<resource_name> -n openshift-machine-apiここでは、以下のようになります。
<resource_kind>-
machine.machine.openshift.ioを持つコンピュートマシン、またはmachineset.machine.openshift.ioで設定されたコンピュートマシンを指定します。 <resource_name>- Machine API に移行する Cluster API リソースに対応する Machine API リソースの名前を指定します。
リソース仕様で、
spec.authoritativeAPIフィールドの値を更新します。apiVersion: machine.openshift.io/v1beta1 kind: <resource_kind> metadata: name: <resource_name> [...] spec: authoritativeAPI: MachineAPI [...] status: authoritativeAPI: ClusterAPI [...]ここでは、以下のようになります。
kind-
移行するリソースの種類を指定します。たとえば、コンピュートマシンセットのリソースの種類は
MachineSetであり、コンピュートマシンのリソースの種類はMachineです。 metadata.name- 移行するリソースの名前を指定します。
spec.authoritativeAPI-
このリソースが使用する権威ある API を指定します。たとえば、Cluster API リソースの Machine API への移行を開始するには、
MachineAPIを指定します。 ステータス.authoritativeAPI- 現在の権威ある API の値を指定します。この値は、現在このリソースを管理している API を示します。仕様のこの部分の値は変更しないでください。
重要spec.authoritativeAPIフィールドの値を更新する際は、他の値を変更しないでください。同期コントローラーがspec.authoritativeAPIフィールドの更新を処理する前に、他のコントローラーが他の値の更新を処理する可能性があるため、他の値を変更すると予期しない動作が発生する可能性があります。詳細は、リソース設定の変更時に予期しない動作が発生するを参照してください。
検証
次のコマンドを実行して、変換のステータスを確認します。
$ oc -n openshift-machine-api get <resource_kind>/<resource_name> -o json | jq .status.authoritativeAPIここでは、以下のようになります。
<resource_kind>-
machine.machine.openshift.ioを持つコンピュートマシン、またはmachineset.machine.openshift.ioで設定されたコンピュートマシンを指定します。 <resource_name>- Machine API に移行する Cluster API リソースに対応する Machine API リソースの名前を指定します。
-
変換の進行中、このコマンドは
Migratingという値を返します。この値が長時間続く場合は、openshift-cluster-apinamespace のcluster-capi-operatorデプロイメントのログをチェックして詳細を確認し、潜在的な問題を特定してください。 -
変換が完了すると、このコマンドは
MachineAPIの値を返します。
重要現在の authoritative API を使用する対応するリソースを削除する場合を除き、現在の authoritative API を使用しない nonauthoritative リソースは削除しないでください。
現在の authoritative API を使用していない nonauthoritative リソースを削除すると、同期コントローラーは、現在の authoritative API を使用する対応するリソースを削除します。詳細は、リソース移行のトラブルシューティング コンテンツの、「予期しないリソース削除動作」を参照してください。
11.6.1.2. コンピュートマシンの権威ある API タイプ
コンピュートマシンの authoritative API は、それを作成する Machine API コンピュートマシンセット内の .spec.authoritativeAPI フィールドと .spec.template.spec.authoritativeAPI フィールドの値によって異なります。
|
|
|
|
|
|
|
|
|
|
|
|
|
新しいコンピュートマシンの |
|
|
|
|
.spec.authoritativeAPI 値が ClusterAPI の場合、Machine API マシンセットは authoritative ではないため、.spec.template.spec.authoritativeAPI 値は使用されません。その結果、Machine API を authoritative として持つコンピュートマシンを作成する唯一の組み合わせは、.spec.authoritativeAPI と .spec.template.spec.authoritativeAPI の値が MachineAPI である場合です。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}