クラスタへのノードの追加

OCIにデプロイされたRed Hat OpenShiftクラスタにノードを追加する方法について学習します。

前提条件

始める前に、次のものがあることを確認してください。

  • OCIで機能するOpenShiftクラスタ。

  • OpenShiftコンソールおよびOCIでプロビジョニングされたクラスタ(そのkubeconfigファイルを含む)へのアクセス。

  • ターゲット・クラスタに追加されたノードをブートするためのISOイメージ。このイメージはノードの追加操作で生成する必要があり、初期クラスタ作成に使用されるイメージとは異なります。

    • 支援インストーラ・クラスタ:支援インストーラを使用してクラスタを作成した場合は、Red Hat Hybrid Cloud ConsoleまたはOpenShift CLI (oc)バージョン4.17以降を使用してイメージを作成できます。手順については、Webコンソールでのホストの追加およびOpenShift CLI (oc)を使用したISOイメージの生成(Red Hatのドキュメント)を参照してください。
    • エージェントベースのインストーラ・クラスタ:エージェントベースのインストーラを使用してクラスタを作成した場合は、OpenShift CLI (oc)バージョン4.17以降を使用してイメージを作成する必要があります。詳細は、「OpenShift CLI (oc)を使用したISOイメージの生成」を参照してください。
  • OCI Computeインスタンスおよびロード・バランサを管理する権限。詳細は、IAMの概要および共通ポリシーを参照してください。

パート1: OCIでのコンピュート・ノードのプロビジョニング

リソース・マネージャ・サービスのadd-nodes-v1.x.x.zipファイルを使用してOCIコンピュート・ノードをプロビジョニングするには、この項の手順に従います。

OpenShiftクラスタに対する計算ノードのプロビジョニング
  1. GitHubのoci-openshift-releasesページに移動します。リリースの「アセット」セクションから、add-nodes-v1.x.x.zipファイルをダウンロードします。ここで、1.x.xはリリース番号を示します。たとえば、ファイルのリリース1.0.0はadd-nodes-v1.0.0.zipという名前です。
  2. OCIコンソールにサインインします。手順が必要な場合は、OCIスタート・ガイドでコンソールへのサインインを参照してください。
  3. ナビゲーション・メニューを開き、「開発者サービス」を選択します。「リソース・マネージャ」で、「スタック」を選択します。
  4. 「スタックの作成」を選択します
  5. 「スタック情報」セクションで、「自分の構成」を選択します。「.Zipファイル」を選択し、add-nodes.zipファイルをアップロードします。構成ソースを指定したら、「次へ」を選択します。
  6. OpenShift「クラスタ構成」セクションで、リクエストされた値を指定します。OpenShiftクラスタを含むコンパートメントであるOCIテナンシのOCIDsが必要になります。OpenShiftイメージ・ソースURIの場合は、OCIオブジェクト・ストレージにアップロードしたノードを追加するために、ISOイメージの事前認証済リクエスト値を貼り付けます。このイメージの生成の詳細は、このトピックの前提条件を参照してください。
  7. 「コントロール・プレーン・ノード構成」セクションで、クラスタに追加するコントロール・プレーン・ノードの詳細を指定します。シェイプ、ocpu、メモリー、ブート・ボリューム・サイズ、ボリューム・パフォーマンス・ユニット(VPU)などのノード変数の詳細は、「OpenShiftコンテナ・プラットフォーム・インフラストラクチャの作成」のトピックを参照してください。
  8. 「コンピュート・ノード構成」セクションで、クラスタに追加するコンピュート・ノードの詳細を指定します。
  9. 「作成」を選択してスタックを作成します。コンソールは、新しいスタックのスタックの詳細ページにリダイレクトされます。
  10. スタックの詳細ページで、「適用」を選択して適用ジョブを作成し、クラスタの新しいノードをプロビジョニングします。適用ジョブの実行後、ジョブの詳細を取得してそのステータスを確認します。成功(SUCCEEDED)は、ジョブが完了したことを示します。

パート2: クラスタへのノードの追加

「OpenShiftクラスタのコンピュート・ノードのプロビジョニング」セクションのステップを完了すると、新しいノードをOpenShiftクラスタに追加できるようになります。クラスタ・タイプに基づいて指示に従います。

補助インストーラのクラスタ手順(コンソール)

Assistedインストーラを使用してクラスタを作成した場合は、Red Hat Hybrid Cloud Consoleおよびクラスタ・コンソールを使用して、新しいノードをクラスタに追加し、証明書署名リクエスト(CRS)を承認できます。

または、OpenShift CLI (oc)バージョン4.17以降を使用して、これらのタスクを実行できます。CLIを使用するには、「CLIを使用したクラスタへのノードの追加」の手順に従います。

OpenShift Webコンソールでのクラスタへのホストの追加
  1. OpenShift Hybrid Cloudコンソールのクラスタ詳細ページ(https://console.redhat.com/openshift/)に移動し、「ホストの追加」タブを選択して「ホストの追加」セクションを表示します。
    ノート

    OpenShift Hybrid Cloudコンソールに「不十分な」エラー・メッセージが表示された場合は、OpenShiftコンソールでノードを追加する際の「不十分な」エラーのトラブルシューティングの手順を参照してください。
  2. 新しいホストが「準備完了」状態になったら、クラスタの詳細ページで「準備完了ホストのインストール」ボタンを選択して続行します。新しいホストがブートし、OpenShiftクラスタに登録されます。インストールを完了するには、クラスタのOpenShift Webコンソールで承認する必要があります。手順については、Approve new nodes in the cluster consoleを参照してください。
クラスタ・コンソールでの新規ノードの承認
  1. クラスタのOpenShift Webコンソールにサインインします。
  2. 「コンピュート」「ノード」の順に選択して、クラスタで使用可能なノードのリストに移動します。

    Webベースのクラスタ・コンソールでのクラスタのノードのリスト・ビューのイメージです。

  3. 新しいノードの行の [検出]リンクを選択します。
  4. 「証明書の承認が必要です」ダイアログで、「承認」を選択してクラスタにノードを追加します。ノードに保留中のサーバー認証署名リクエストがある場合、ノードのステータスは「準備中」に変わります。

    「証明書の承認が必要」ダイアログのイメージです。

  5. 「未準備」状態のノードの場合、「未準備」リンクを選択して「ノード・ステータス」ダイアログを開きます。署名リクエスト情報を確認し、「承認」を選択して署名プロセスを完了し、クラスタ内のワークロードをノードに取得させます。

    サーバー署名リクエスト承認ボタンが表示されたノード・ステータス・ダイアログのイメージです。

エージェントベースのインストーラのクラスタ手順(CLI)

エージェントベースのインストーラを使用してクラスタを作成した場合は、OpenShift CLI (oc)バージョン4.17以降を使用して、新しいノードをクラスタに追加し、証明書署名リクエスト(CRS)を承認する必要があります。CLIを使用してターゲット・クラスタに接続するには、kubeconfigファイルが必要になります。詳細は、Red Hat OpenShift CLI (oc)ドキュメントのクラスタへのノードの追加を参照してください。

CLIを使用したクラスタへのノードの追加
  1. CLIでターゲットクラスタへのアクティブな接続を作成します。
  2. 次のコマンドを実行して、ノードがブートされ、クラスタに追加できる状態になっていることを確認します。

    $ oc adm node-image monitor --ip-addresses <ip_addresses>

    <ip_addresses>は、追加するノードのIPアドレスのリストを指定します。

  3. CSRごとに次のコマンドを実行して、CSRを承認します。

    $ oc adm certificate approve <csr_name>

    保留中のCSRに関する情報が必要な場合は、次のコマンドを実行します。

    $ oc get csr