自動割り当てのためのホスト・ラベルを使用した Satellite ワーカー・プールの作成

ホスト・ラベルを指定して、Satellite クラスターにワーカー・プールを作成します。 これによって、Satellite で空きホストをワーカー・プールに自動的に割り当てることができます。 詳しくは、ホスト自動割り当ての使用を参照してください。

開始前に

• IBM Cloud の IAM で、Kubernetes Service の対象クラスターに対してオペレーターのプラットフォーム・アクセス役割を持っていることを確認します。
• オプション: ワーカー・プールと一致するホスト・ラベルが付いた Satellite ロケーションにホストを 接続 またはそのようなホストを リスト します。 後でワーカー・プールを作成すると、それらの空きホストがワーカー・プールに自動的に割り当てられます。

Satellite クラスター内にワーカー・プールを作成するには、以下のようにします。

1. アカウントの Satellite クラスターをリスト表示します。

   ibmcloud oc cluster ls --provider satellite
   

2. ワーカー・プールを作成するクラスターの詳細を取得します。 ワーカー・ゾーンをメモします。

   ibmcloud oc cluster get --cluster CLUSTER
   

3. 以下のパラメーターを指定して、ワーカー・プールを Satellite クラスターに作成します。

--cluster

クラスタの名前またはIDを入力してください。

--name

ワーカープールに名前を付けてください。

--size-per-zone

ワーカー・プールがまたがる各ゾーンのワーカー・ノードの数を指定します。 この値は、後でワーカー・プールのサイズ変更を行うことで変更可能です。

--zone

Satellite のロケーション内で、ワーカープールを作成する初期ゾーンを選択してください。このゾーンは、クラスターの詳細情報から取得したものです。 後で他のゾーンを追加することができます。 --host-label : Satellite のロケーションにある利用可能なホストと、ワーカープールの要求容量を一致させるために、ラベルを追加してください。 Satellite ホストには cpu=number ホスト・ラベルが自動的に付与されるので、このホスト・ラベルだけを使用してもかまいません。 env=prod などのカスタム・ホスト・ラベルを追加することもできます。 重要: 後でワーカー・プールのホスト・ラベルを更新することはできないため、割り当てる際には注意してください。 Satellite ホストのラベルは、必要に応じて変更できます。

--operating-system RHEL_9_64|REDHAT_8_64|RHCOS: オプション。 クラスター内のワーカー・ノードのオペレーティング・システム。 クラスタのバージョン別に利用可能なオペレーティングシステムの一覧については 、 Red Hat OpenShift on IBM Cloud のバージョン情報 をご覧ください。 オプションが指定されていない場合、クラスター・バージョンに対応するデフォルトのオペレーティング・システムが使用されます。

--entitlement ENTITLEMENT

オプション: Red Hat OpenShift の資格がある場合は、このオプションを ocp_entitled に設定します。 ワーカーの数（--workers ）とフレーバー（--flavor ）を指定する際は、 IBM Passport Advantage。

使用権を超えないようにしてください。 他のクラウド・プロバイダーや他の環境でも OpenShift Container Platform の使用権を使用できることを忘れないでください。 後で請求に関する問題が起きないように、使用権のあるものだけを使用していることを確認してください。 例えば、CPU 4 個とメモリー 16 GB のワーカー・ノード 2 台に対する OCP ライセンスの使用権がある場合に、CPU 4 個とメモリー 16 GB のワーカー・ノード 2 台からなるワーカー・プールを作成したとします。 ライセンス全体を使用したため、他のワーカー・プール、クラウド・プロバイダー、または環境に同じライセンスを使用することはできません。

worker-pool create コマンドの例

ibmcloud oc worker-pool create satellite --cluster CLUSTER_NAME_OR_ID --name POOL_NAME --size-per-zone NUMBER --zone SATELLITE_ZONE --entitlement ENTITLEMENT --host-label cpu=NUMBER --host-label memory=NUMBER [--host-label KEY=VALUE] [--operating-system SYSTEM]

Red Hat CoreOS ホストを使用するワーカー・プールを作成するための worker-pool create コマンドの例。

ibmcloud oc worker-pool create satellite --cluster CLUSTER_NAME_OR_ID --name POOL_NAME --size-per-zone NUMBER --zone SATELLITE_ZONE --host-label cpu=NUMBER --host-label memory=NUMBER --operating-system RHCOS

ワーカー・プールが作成されました。

• 一致するラベルが付いた Satellite ホストが使用可能であれば、それらのホストがワーカー・ノードとしてワーカー・プールに割り当てられます。 ホストにゾーン・ラベルも付いている場合は、そのゾーンにしかホストを割り当てられないことに注意してください。
• 空きホストがない場合に、ワーカー・プールにホストを手動で割り当てることができます。 ホストを手動で割り当てると、ワーカー・プールをリバランスしない限り、それ以降のアクションでは、ホストの自動割り当てが無効になることに注意してください。

ホストを割り当てると、ホストの vCPU ごとに Satellite 管理料金が課金されます。 詳細はこちらをご覧ください。

Satellite ワーカー・プールのサイズ変更

ワーカー・プールのサイズを変更して、クラスターの追加のコンピュート容量を要求することができます。

• ホストの自動割り当てが有効になっている場合、Satellite は、ホスト・ラベルがワーカー・プールのホスト・ラベルと一致する限り、使用可能なホストをワーカー・プールに自動的に割り当てます。 使用可能なホストがない場合は、ラベルが Satellite の場所と一致する ホストを接続します 。
• ホストの自動割り当てが無効な場合に、ワーカー・プールのサイズを変更すると、自動割り当てが再び有効になります。

Satellite ワーカー・プールのリバランス

ワーカー・プールをリバランスすると、1 ゾーンあたりのワーカー・ノード数として最後に要求した数に応じて、ワーカー・プールのサイズが拡大/縮小されます。 要求した数は、ワーカー・プールの詳細で確認できます。要求する数を設定するには、ワーカー・プールのサイズを変更します。

Satellite クラスタの場合、ワーカー・プールにワーカー・ノードを手動で割り当てている場合は、 ibmcloud oc worker-pool rebalance コマンドを使用しないでください。 手動で割り当てられたワーカーノードでプールのリバランスを行うと、予想以上の数のワーカーノードが削除される可能性があります。

また、Satellite ワーカー・プールでは、リバランスを実行することで、ホスト自動割り当てが再び有効になります。 ワーカー・プールのリバランスは、IBM Cloud コンソールまたは ibmcloud oc worker-pool rebalance コマンドで実行できます。

Satellite ワーカー・プール内のワーカー・ノードの更新

クラシック・ワーカー・ノードの更新と同じ手順に従います。

Satellite ワーカー・プールへのゾーンの追加

ワーカー・プールにゾーンを追加することができます。 ゾーン・ラベルが付いた空き Satellite ホストは、ワーカー・プールのそのゾーンにのみ割り当てることができます。

• Satellite のゾーンについて詳しくは、Satellite のインフラストラクチャー環境の計画 を参照してください。
• ゾーンを追加するには、ibmcloud oc zone add satellite コマンドを参照してください。

Satellite ワーカー・プールの削除

ワーカー・プールを削除すると、クラスター内のすべてのワーカー・ノードが削除されます。 ワーカー・ノードが実行されていたホストは、クラスターへの割り当てから解除され、Satellite ロケーションで使用できなくなります。ただし、ロケーションにはまだ接続されています。 詳しくは、Satellite のワーカー・ノードまたはクラスターの削除を参照してください。