ホストをワーカープールに手動で割り当てる

Satellite のロケーションにホストを接続したら、それらをクラスターや Satellite 対応の IBM Cloud サービスなどのリソースに割り当てて、演算能力を提供します。

Satellite クラスターのワーカー・プールに ホスト自動割り当て を使用することもできます。 ただし、ホストを Satellite ロケーション・コントロール・プレーンに手動で割り当てる必要があります。

ホストを割り当てる際、ホストの仮想CPU 1つにつき、 Satellite の管理手数料が課金されます( vCPU )。 詳細はこちらをご覧ください

始める前に、以下を実行してください。

  1. Satellite に対して、 IBM Cloud Identity and Access Management (IAM)の 「Operator」 プラットフォームロールが割り当てられていることを確認してください。 詳しくは、ユーザー許可の確認を参照してください。
  2. ホストを Satellite ロケーションに接続し、ホストが正常であり、未割り当てであることを確認します。

コンソールからのホストの割り当て

  1. Satellite コンソールから、 「ロケーション」 をクリックします。

  2. Satellite リソースに割り当てるホスト・マシンを接続したロケーションを選択します。

  3. **「ホスト」タブで、リソースに追加する各ホスト・マシンのアクション・メニューから「ホストの割り当て」**をクリックします。

  4. 作成したクラスターを選択し、使用可能なゾーンの 1 つを選択します。 ホストをクラスターに割り当てると、IBM はマシンをブートストラップします。 このプロセスは、完了するまで数分かかります。 ブートストラッピング・プロセス中に、マシンの「正常性」が Ready から Provisioning に変わります。

  5. ホストが正常にクラスターに割り当てられていることを確認します。 割り当てが成功していると、IP アドレスがホストに追加され、**「正常性」**状況が Normal に変わります。

  6. この手順を繰り返して、クラスターのデフォルトのワーカー・プールのすべてのゾーンに、ホストをワーカー・ノードとして割り当てます。

    ホストがコントロールプレーンに正常に割り当てられた後、 IBM のモニタリング設定にはさらに20~30分ほどかかります。 さらに、お客様のロケーション用にドメインネームシステム(DNS)レコードが作成され、ホストのIPアドレスが自動的に登録されてDNSレコードに追加されます。これにより、お客様のロケーションにおける負荷分散とヘルスチェックが可能になります。 このDNS登録手続きが完了するまで、最大30分かかります。 この処理中、位置情報のステータスは「 対応が必要 」の状態が続き、「 Satellite is attempting to recover 」や「 Verify that the Satellite location has a DNS record for load balancing requests to the location control plane 」といったエラーが断続的に表示されます。

CLI からのホストの割り当て

  1. ロケーションのホストをリストし、unassigned の状況のホストを見つけます。

    ibmcloud sat host ls --location LOCATION_NAME_OR_ID
    
  2. ロケーションから、少なくとも 3 つのコンピュート・ホストをワーカー・ノードとして Satellite コントロール・プレーンまたは既存の Red Hat OpenShift on IBM Cloud クラスターに割り当てます。 ホストを割り当てると、IBM はマシンをブートストラップします。 このプロセスは、完了するまで数分かかります。 ホスト ID を使用してホストを割り当てることも、ホストをロケーションに割り当てるために必要なラベルを定義することもできます。

    • ホスト ID を使用してホストを割り当てる例を次に示します。
        ibmcloud sat host assign --location LOCATION_NAME_OR_ID  --cluster CLUSTER_NAME_OR_ID --host HOST_ID --worker-pool default --zone ZONE
        ```
    - `use:satcluster` ラベルを使用してホストを割り当てる例を次に示します。
    ```sh {: pre}
        ibmcloud sat host assign --location LOCATION_NAME_OR_ID --cluster LOCATION_ID --host-label "use:satcluster" --worker-pool default --zone us-east-1
        ```
        | コンポーネント | 説明 |
        |--------------------|------------------|
        | `--location <location_name_or_ID>` | クラスターを作成したロケーションの名前または ID を入力します。 ロケーションの名前または ID を確認するには、`ibmcloud sat location ls` を実行します。 |
        | `--cluster <cluster_name_or_ID>` | 先ほど作成した Red Hat OpenShift on IBM Cloud クラスターの名前または ID を入力します。 クラスターの名前または ID を取得するには、`ibmcloud ks cluster ls` を実行してください。 ホストを Satellite コントロール・プレーンに割り当てる場合は、ロケーション ID をクラスター ID として入力する必要があります。 ロケーション ID を取得するには、`ibmcloud sat location ls` を実行します。 |
        | `--host <host_name_or_ID>` | ワーカー・ノードとして Satellite リソースに割り当てるホストの ID を入力します。 ホスト ID を表示するには、`ibmcloud sat host ls --location LOCATION_NAME` を実行します。 `--host-label` オプションを使用して、クラスターに割り当てるホストを識別することもできます。 |
        | `--host-label <label>` | 割り当てるホストを識別するために使用するラベルを入力します。 ラベルはキーと値のペアで、ホスト・マシンに存在している必要があります。 `label` オプションを指定してこのコマンドを実行すると、ラベルが一致する最初の `unassigned` 状態のホストが Satellite リソースに割り当てられます。 |
        | `--worker-pool <worker-pool>` | コンピュート・ホストを接続するワーカー・プールの名前を入力します。 クラスター内の使用可能なワーカー・プールを見つけるには、`ibmcloud oc worker-pool ls --cluster CLUSTER_NAME_OR_ID` を実行します。 このオプションを指定しない場合、コンピュート・ホストはデフォルトのワーカー・プールに自動的に追加されます。 |
        | `--zone <zone>` | コンピュート・ホストを割り当てるゾーンの名前。 自分のロケーションのゾーン名を確認するには、`ibmcloud sat location get --location` を実行して、`Host Zones` フィールドを探します。 |
        {: caption="このコマンドの構成要素について" caption-side="bottom"}
    
    - 次の例では、 `os=RHCOS` ( Red Hat CoreOS )というホストラベルを使用してホストを割り当てています。
    ```sh {: pre}
        ibmcloud sat host assign --location LOCATION_NAME_OR_ID  --cluster CLUSTER_NAME_OR_ID --host-label os=RHCOS --zone ZONE
        ```
    
  3. ワーカー・ノードとして Satellite リソースに割り当てるすべてのコンピュート・ホストについて、前のステップを繰り返します。

  4. すべてのコンピュート・ホストのブートストラップ・プロセスが完了し、ホストが Satellite リソースに正常に割り当てられるまで数分待ちます。 すべてのホストには、クラスター、ワーカー・ノード ID、および IP アドレスが割り当てられます。

    ibmcloud ks worker get --cluster <cluster_name_or_ID> --worker <worker_ID> を実行して、計算ホストのブートストラッピング・プロセスをモニターできます。

    ibmcloud sat host ls --location LOCATION_NAME_OR_ID
    

    出力例

    Retrieving hosts...
    OK
    Name              ID                     State      Status   Cluster             Worker ID                                                 Worker IP   
    satcluster        brkijjq20r3nd89b1sog   assigned   Ready    satcluster          sat-satc-dd629ca11947c4aaec1a0208e0a37ca790475ee0   169.62.196.24   
    satcluster2       brkiku2202thnmhb1sp0   assigned   Ready    satcluster          sat-satc-69f2410d3ecfea9127aeec07f01475f241728a16   169.62.196.22   
    satcluster3       brkiltb20m0oqr29mo2g   assigned   Ready    satcluster          sat-satc-9985014f499827ddde3ce3e5bedad26af5a73263   169.62.196.29
    controlplane01    brjrgp920bg4u254brr0   assigned   Ready    infrastructure      sat-virtualser-4d7fa07cd3446b1f9d8131420f7011e60d372ca2   169.62.196.30   
    controlplane02    brjrdmd20dfjgaai4vc0   assigned   Ready    infrastructure      sat-virtualser-9826f0927254b12b4018a95327bd0b45d0513f59   169.62.196.23   
    controlplane03    brjs18u20ohqh54svnog   assigned   Ready    infrastructure      sat-virtualser-948b454ea091bd9aeb8f0542c2e8c19b82c5bf7a   169.62.196.20