Oracle Cloud Infrastructureドキュメント

Terraformを使用したエージェント・ベースのインストーラを使用したクラスタのインストール

エージェントベースのインストーラでTerraformスクリプトを使用して、Red Hat OpenShift Container PlatformのOCIインフラストラクチャをプロビジョニングする方法について学習します。

Red Hat OpenShiftプラグインを使用して、Terraformでインフラストラクチャを自動的にプロビジョニングします。Terraformスタックの最新バージョンは、Red Hat OpenShiftプラグインのスタック情報ページにあります。

Terraformの以前のバージョンは、GitHubのOCIリリース上のOpenShiftページからアクセスできます。「アセット」セクションから、必要なバージョンのcreate-cluster zipファイルをダウンロードします。

重要

  • インストールの失敗を回避するために、create-clusterスタックを実行する前にcreate-resource-attribution-tagsスタックを実行します。詳細については、前提条件のトピックを参照してください。
  • create-resource-attribution-tagsスタックは1回のみ実行する必要があります。タグ・ネームスペースおよび定義済タグがすでに存在する場合は、今後のインストールでこのステップをスキップできます。
  • OpenShiftには、インスタンス、ボリュームおよびネットワーキング・リソースに対する操作を実行するための管理権限が必要です。OpenShiftを専用コンパートメントにデプロイして、同じコンパートメントで実行されている可能性のある他のアプリケーションとの競合を回避します。

スタックによって作成されたリソースのリストは、OpenShiftのTerraform定義済リソースを参照してください。

  1. ナビゲーション・メニューを開き、「開発者サービス」、「Red Hat OpenShift」の順に選択します。
  2. 「スタック情報」ページで、オプションの「名前」および「説明」を入力します。
    • Terraformスタックの最新バージョンが自動的にアップロードされます。
    • 「コンパートメントに作成」および「Terraformバージョン」フィールドに事前移入されます。
  3. 「変数の構成」ページで、次のフィールドに入力し、必要に応じて他の変数のデフォルト値を編集します。
    セクション フィールド 値
    OpenShiftクラスタ構成 コンパートメント ドロップダウン・メニューから「コンパートメント」を選択します。
    クラスタ名 cluster_name値を入力します。Red Hat Hybrid CloudコンソールでのISOイメージの作成中に入力したものと同じクラスタ名を使用します。
    インストール方法 「エージェントベース」を選択します。
    OpenShiftイメージおよびインスタンスの作成 このオプションは無効にする必要があります(チェックマークがある場合は削除してください)。
    OpenShiftリソース属性タグ OpenShiftリソース属性タグ付けのタグ・ネームスペース・コンパートメント タグ・ネームスペース・コンパートメントを選択します。

    ノート: Terraformスタックを適用する前に、指定したタグが存在することを確認します。リソース・タグ付けのタグ・ネームスペースが作成されるコンパートメントは、デフォルトで現在のコンパートメントに設定されます。OCIリソースに対するOpenShift属性の場合、タグ・ネームスペースおよび定義済タグはopenshift-tagsおよびopenshift-resourceに設定されます。openshift-tagsネームスペースがすでに存在する場合は、正しく定義され、適用されていることを確認します。たとえば: defined-tags" - {"openshift-tags"- {"openshift-resource" - "openshift-resource-infra"} }
    ネットワーキング構成 プライベートDNSの有効化 オプションで、このオプションにチェックマークを入れることで、DNSゾーンをプライベートに設定できます。プライベートDNSゾーンの場合、クラスタに到達するようにlocal /etc/hostsファイルを構成する必要があります。
    ゾーンDNS ゾーンのDNSレコードを格納するDNSネーム・サーバーを指定します(openshift-demo.devcluster.openshift.comなど)。これは、ISOイメージの作成時にRed Hat Hybrid Cloudコンソールに入力されたベース・ドメインと同じ値です。
    VCN DNSラベル VCN用のDNSラベル。VNICのホスト名およびサブネットのDNSラベルとともに使用され、サブネット内の各VNICの完全修飾ドメイン名(FQDN)を形成します。
    VCN CIDR OpenShiftクラスタのVCNのIPv4 CIDRブロック。
    パブリック・サブネットCIDR IPv4 CIDRは、OpenShiftクラスタのパブリック・サブネットのブロックです。
    プライベート・サブネットCIDR IPv4 CIDRは、OpenShiftクラスタのプライベート・サブネットのブロックです。
    (オプション) セカンダリ・プライベート・サブネットCIDR IPv4 CIDRは、OpenShiftベア・メタル・クラスタのプライベート・サブネットのブロックです。
    レンデバスIP エージェントベースのインストーラを使用したクラスタのブートストラップに使用されるIP。この値は、agent-config.yamlファイルで指定されたrendezvousIP値と一致する必要があります。ベア・メタル・インスタンスの場合、このIPアドレスはセカンダリ・プライベート・サブネットCIDR内にある必要があります
    ロード・バランサの最大帯域幅 ロード・バランサが達成できる最大帯域幅(イングレスとエグレス)を設定する帯域幅値(Mbps)。
    ロード・バランサ最小帯域幅 事前にプロビジョニングされた帯域幅の合計(イングレスとエグレス)を設定する帯域幅値(Mbps)。
  4. 「次へ」を選択します。
  5. 「確認」ページで、スタック情報および変数を確認します。
  6. 「作成」を選択してスタックを作成します。コンソールは、新しいスタックのリソース・マネージャ・スタックの詳細ページにリダイレクトされます。
  7. スタックの詳細ページで、「適用」を選択して適用ジョブを作成し、クラスタのインフラストラクチャをプロビジョニングします。適用ジョブの実行後、ジョブの詳細を取得してそのステータスを確認します。成功(SUCCEEDED)は、ジョブが完了したことを示します。スタック適用ジョブには最大5分かかります。完了すると、ISOイメージおよびコンピュート・インスタンスを除くすべてのOpenShiftリソースが作成されます。
  8. リソース・マネージャの「スタック」ページで、スタックの名前を選択して詳細を表示します。ジョブのリスト・ビューが表示されない場合は、「リソース」セクションの下の「ジョブ」を選択してジョブのリストを表示します。
  9. スタック作成のジョブを選択します。「ジョブ詳細」ページがコンソールに表示されます。
  10. 「リソース」セクションで「出力」を選択して、ジョブの出力のリストを表示します。
  11. 出力dynamic_custom_manifestで、「表示」を選択して出力の内容を表示します。
  12. 「コピー」を選択して、出力の内容をコピーします。ノート:次のステップでこの出力を貼り付けるとインデントの問題が発生する可能性があるため、テキストを手動で選択してコピーしないことをお薦めします。
  13. テキストまたはコード・エディタを使用して、コピーした出力を新しいmanifest.yamlファイルに保存します。
  14. クラスタをインストールするための構成ファイルおよびブート可能なISOイメージを作成します。手順は、OCIにクラスタをインストールするための構成ファイルの作成(Red Hatのドキュメント)を参照してください。
    構成ファイルおよびISOイメージを作成したあとにこのドキュメントに戻り、インストールを続行します。
  15. 検出ISOイメージ・ファイルをOCIオブジェクト・ストレージのバケットにアップロードします。手順が必要な場合は、オブジェクト・ストレージへのデータの配置を行います。
  16. OCIコンソールで、オブジェクト・ストレージ・バケットを作成し、検出ISOをバケットにアップロードします。
  17. アップロードされた検出ISOを検索し、次のステップを実行します。
    1. オブジェクト・ストレージにISOの事前認証済リクエストを作成します。
    2. 次のステップで、生成されたURLをコピーしてOpenShiftイメージ・ソースURIとして使用します。詳細は、オブジェクト・ストレージの事前認証済リクエストを参照してください。
  18. リソース・マネージャ・サービスに移動し、OpenShiftをインストールするために作成したスタックのスタック詳細ページにアクセスします。
  19. 「リソース」で、「変数」を選択します。
  20. 「変数の編集」を選択します。
  21. 「OpenShiftクラスタ構成」セクションで、「OpenShiftイメージおよびインスタンスの作成」チェック・ボックスを選択します。
  22. 「コントロール・プレーン・ノード構成」セクションで、事前認証済リクエスト文字列をOpenShiftイメージ・ソースURIフィールドに貼り付けます。
  23. 「コントロール・プレーン・ノード構成」および「コンピュート・ノード構成」セクションの値を確認し、「コントロール・プレーン・ノード数」および「コンピュート・ノード数」の値がagent-configファイルの値と一致していることを確認します。
  24. 「次へ」を選択して、変更内容を確認して保存します。
  25. スタックの詳細ページで、「適用」を選択して、スタックの別の適用ジョブを実行します。このジョブが完了するまでに最大20分かかります。このジョブは、クラスタ内のコンピュート・インスタンスによって使用されるカスタム・ソフトウェア・イメージを作成し、コンピュート・インスタンスをプロビジョニングします。コンピュート・インスタンスがスタックによってプロビジョニングされると、クラスタのインストールが自動的に開始されます。
    次の手順エージェントベースのクラスタ・インストールがOCIで実行されていることの確認(Red Hatのドキュメント)の手順に従って、クラスタが実行されていることを確認します。このステップは、OpenShift Container Platform CLIで実行されます。