Oracle Cloud Infrastructureドキュメント

Terraformを使用したクラスタ・インフラストラクチャのプロビジョニング

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

リソース・マネージャ・サービスを使用して、Terraformでインフラストラクチャを自動的にプロビジョニングします。リソース・マネージャで、最初にスタックを作成します。これは、create-cluster-vX.X.X.zipファイルに含まれるTerraformスクリプトに基づく構成です。次に、リソースをプロビジョニングするには、スタックを処理してインフラストラクチャ・リソースを作成する適用ジョブを作成します。

詳細は次のトピックを参照してください:

リソース・マネージャで使用されるcreate-cluster-vX.X.X.zipファイルによって作成されたリソースのリストは、OpenShiftのTerraform定義済リソースを参照してください。

  1. ナビゲーション・メニューを開き、「開発者サービス」を選択します。「リソース・マネージャ」で、「スタック」を選択します。
  2. 「スタックの作成」を選択します
  3. 「スタック情報」セクションで、「自分の構成」を選択します。「.Zipファイル」を選択し、create-cluster-vX.X.X.zipファイルをアップロードします。構成ソースを指定したら、「次へ」を選択します。
  4. 「変数の構成」ページで、次のフィールドに入力します:
    セクション フィールド 値
    OpenShiftクラスタ構成 コンパートメント ドロップダウン・メニューから「コンパートメント」を選択します。
    クラスタ名 cluster_name値を入力します。Red Hat Hybrid CloudコンソールでのISOイメージの作成中に入力したものと同じクラスタ名を使用します。
    インストール方法 「エージェントベース」を選択します。
    OpenShiftイメージおよびインスタンスの作成 このオプションは無効にする必要があります(チェックマークがある場合は削除してください)。
    ネットワーキング構成 プライベート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)。
    タグ付けの構成 既存のタグ付けリソースの使用 既存のOCIタグ・ネームスペースとその定義済タグを使用するには、このオプションを選択します。
    タグ・ネームスペース (オプション) OpenShiftクラスタで使用されるOCIリソースにタグ付けするために作成または再使用するタグ・ネームスペースの名前。
    タグ・ネームスペース・コンパートメントOCID タグ・ネームスペースを含むコンパートメントのOCID。
    タグの一貫性待機期間 タグ付きリソースを作成する前に作成操作が待機する秒数。待機期間により、新しいタグを伝播してリソースに適用できます。
  5. 「次へ」を選択し、「スタック情報」および「変数」を確認します。
  6. 「作成」を選択してスタックを作成します。コンソールは、新しいスタックのスタックの詳細ページにリダイレクトされます。
  7. スタックの詳細ページで、「適用」を選択して適用ジョブを作成し、クラスタのインフラストラクチャをプロビジョニングします。適用ジョブの実行後、ジョブの詳細を取得してそのステータスを確認します。成功(SUCCEEDED)は、ジョブが完了したことを示します。スタック適用ジョブには最大5分かかります。完了すると、ISOイメージおよびコンピュート・インスタンスを除くすべてのOpenShiftリソースが作成されます。
  8. 「ジョブ」のリストで、スタック作成のジョブを選択します。「ジョブの詳細」ページがコンソールに表示されます。ジョブのリストが表示されない場合は、「リソース」セクションの下の「ジョブ」を選択して、ページのこのセクションを表示します。
  9. 「リソース」セクションで「出力」を選択して、ジョブの出力のリストを表示します。
  10. 「コピー」を選択して、出力の内容をマシンのクリップボードにコピーします。ノート:次のステップでこの出力を貼り付けるとインデントの問題が発生する可能性があるため、テキストを手動で選択してコピーしないことをお薦めします。
  11. インストール・プロセスの後半で使用するために、dynamic_custom_manifestの出力をローカル・マシン上のファイルにコピーします。
  12. クラスタをインストールするための構成ファイルおよびブート可能なISOイメージを作成します。手順については、Red HatドキュメントのOCIにクラスタをインストールするための構成ファイルの作成を参照してください。構成ファイルおよびISOイメージを作成した後、このドキュメントに戻り、インストールを続行します。
  13. 検出ISOイメージ・ファイルをOCIオブジェクト・ストレージのバケットにアップロードします。手順が必要な場合は、オブジェクト・ストレージへのデータの格納を参照してください。
  14. オブジェクト・ストレージでISOファイルの事前認証済リクエストを作成します。手順が必要な場合は、事前認証済リクエストの使用を参照してください。事前認証済リクエスト文字列をクリップボードにコピーします。
  15. リソース・マネージャ・サービスに戻り、OpenShiftをインストールするために作成したスタックのスタック詳細ページに移動します。「リソース」で、「変数」を選択します。
  16. 「変数の編集」を選択します。
  17. OpenShift「クラスタ構成」セクションで、「OpenShiftイメージおよびインスタンスの作成」オプションを有効にします(チェック・ボックスにチェックマークを入れます)。
  18. 「コントロール・プレーン・ノード構成」セクションで、事前認証済リクエスト文字列をOpenShift「イメージ・ソースURI」フィールドに貼り付けます。
  19. 「コントロール・プレーン・ノード構成」および「コンピュート・ノード構成」セクションの値を確認し、「コントロール・プレーン・ノード数」および「コンピュート・ノード数」の値がagent-configファイルの値と一致していることを確認します。変更を確認して保存するには、「次へ」を選択します。
  20. スタックの詳細ページで、「適用」を選択して、スタックに対して別の適用ジョブを実行します。このジョブの完了には最大20分かかります。ジョブによって、クラスタ内のコンピュート・インスタンスによって使用されるカスタム・ソフトウェア・イメージが作成され、コンピュート・インスタンスがプロビジョニングされます。コンピュート・インスタンスがスタックによってプロビジョニングされると、クラスタのインストールが自動的に開始されます。
  21. Red Hatドキュメントのエージェントベースのクラスタ・インストールがOCIで実行されていることの確認の手順を使用して、クラスタが実行されていることを確認します。このステップは、OpenShift Container Platform CLIで実行します。