Oracle Cloud Infrastructureドキュメント

前提条件

Oracle Cloud Infrastructure (OCI)上のOpenShift Container Platformクラスタのインストール・プロセスを開始する前に、インストールを成功させるために必要なすべてのアカウント、リソースおよび構成があることを確認してください。

アカウントおよびリソース

追加リソース

次のものも必要です。
  1. OCIのクラスタ・リソースで実行されるOpenShift Container Platformコンソールを提供するインターネット・ドメイン。
  2. クラスタ・インストール用のSSHキー・ペア。
  3. Red Hat Hybrid Cloud Consoleからのプル・シークレット。詳細は、Using image pull secrets (Red Hat documentation)を参照してください。
  4. (オプション)クラスタ・リソースの専用コンパートメント。既存のコンパートメントを使用することもできます。詳細は、コンパートメントの理解およびコンパートメントの作成を参照してください。
  5. (オプション)検出ISOイメージを格納するオブジェクト・ストレージ・バケット。既存のバケットを使用することもできます。詳細は、オブジェクト・ストレージ・バケットの作成を参照してください。
ノート

  • ファイアウォール・アクセス(切断された環境または制限された環境): OCI環境でファイアウォールを使用し、テレメトリ・サービスの使用を計画している場合は、ファイアウォールがOpenShiftコンテナ・プラットフォームを許可リストに登録して必要なサイトにアクセスしていることを確認します。詳細は、「OpenShift Container Platform用のファイアウォールの構成(Red Hatのドキュメント)」を参照してください。
  • サポートされているインスタンス・シェイプ: クラスタのOCIインスタンスを作成する前に、Red Hat Enterprise Linux (RHEL)で動作保証されているVMおよびベア・メタル・シェイプを確認します。詳細は、Red Hatエコシステム・カタログ・ポータルのサポートされているシェイプおよびクラウド・インスタンス・タイプを参照してください。

  • 権限: OpenShiftでは、インスタンス、ボリュームおよびネットワーキング・リソースに対する操作を実行するための管理権限が必要です。OpenShiftを専用コンパートメントにデプロイして、同じコンパートメントで実行されている可能性のある他のアプリケーションとの競合を回避します。

リソース属性タグ

OCIにOpenShiftクラスタをインストールする前に、GitHubの「OCIリリースのOpenShift」ページからcreate-resource-attribution-tagsスタックをダウンロードして実行します。このスタックは、OpenShiftリソースのタグ付けに使用されるopenshift-tagsタグ・ネームスペースおよびopenshift-resource定義済タグを作成します。これらは、他のTerraformスタックを使用する前に必要です。

手順については、「タグおよびタグ・ネームスペースの概念」を参照してください。タグ付けの詳細は、GitHubの「OCI上のOpenShiftのTerraform定義リソース」ページを参照してください。特定のリソース定義については、shared_modulesディレクトリのresource_attribution_tagフォルダにアクセスします。

ノート

  • インストールの失敗を回避するために、create-clusterスタックを実行する前にcreate-resource-attribution-tagsスタックを実行します。
  • create-resource-attribution-tagsスタックは1回のみ実行する必要があります。タグ・ネームスペースおよび定義済タグがすでに存在する場合は、今後のインストールでこのステップをスキップできます。
  • タグ付けコントローラはバックグラウンドで実行され、インストール中および進行中のリコンシリエーション中に、必要なOpenShiftリソース属性タグがクラスタ・リソースに存在することを確認します。

構成ファイル

OCIコンソールでRed Hat OpenShiftプラグインを開くと、必要な構成ファイルを含むスタックの最新バージョンが自動的にロードされます。

以前のバージョンのスタックにアクセスするには、OCIリリース上のOpenShift GitHubページに移動し、Assetsフォルダからcreate-cluster.zipファイルをダウンロードします。

create-cluster.zipファイルには次のものが含まれます。

  • カスタム・マニフェスト: OpenShiftクラスタのインストールに必要なマニフェスト・ファイル。ファイルの詳細は、Custom Manifestsを参照してください。
  • Terraformスタック: OpenShiftクラスタを作成および管理するためのOCIインフラストラクチャをプロビジョニングするためのTerraformスタック・コード。詳細は、OpenShiftのTerraform定義済リソースを参照してください。
    ノート

    マニフェストまたはTerraformコードを変更するには、oracle-quickstart / oci-openshift GitHubリポジトリをクローニングし、custom_manifestsおよびterraform-stacksディレクトリに直接アクセスできます。makeコマンドを実行して、リポジトリのドキュメントを確認し、新しいTerraformスタックzipファイルを生成します。

既存のVCNを使用するための前提条件

「既存のネットワーキング・インフラストラクチャの使用」を選択する前に、次のリソースを使用して既存のVCNを準備します:

  • 選択したクラスタ構成に必要なインターネット・ゲートウェイ、NAT Gatewayおよびサービス・ゲートウェイ。
  • 必要なゲートウェイおよびクラスタ・トラフィックのルートを含むパブリックおよびプライベートのルート表。
  • 必要なイングレスおよびエグレス・ルールを含むパブリックおよびプライベートのセキュリティ・リスト。
  • ロード・バランサ、コントロールプレーン・ノードおよびコンピュート・ノードのネットワーク・セキュリティ・グループ。
  • プライベートOpenShiftサブネット、個別のプライベート・ベア・メタル・サブネットおよびパブリック・サブネット。

リソース名は、Terraform検出要件を満たす必要があります。必要なリソース名、ルート、およびセキュリティー規則については、Bring Your Own Networkの要件を参照してください。

自動スケーリングの前提条件

自動スケーリングは、OpenShift Container Platform 4.22以降でサポートされています。クラスタインストール後の構成には、最新の create-autoscaler-operatorスタックを使用します。自動スケーリングされたワーカーに使用されるRHCOSイメージは、OpenShiftコンテナ・プラットフォーム・マイナー・バージョンのクラスタと一致する必要があります。同じマイナー・バージョンの異なるzストリームのイメージを使用できます。4.22クラスタで4.23ワーカー・イメージを使用しないでください。

他の前提条件に加えて、自動スケーリング・スタックを作成する場合は、Terraformスタックをダウンロードし(既存のクラスタに自動スケーリングを追加する場合)、自動スケーリングRed Hat Enterprise Linux CoreOS (RHCOS)ソース・イメージを準備して、事前認証済リクエスト(PAR) URLを取得する必要があります。Red Hat OpenShift CLI ocもインストールする必要があります。

  1. 既存のクラスタに自動スケーリングを追加する場合は、https://github.com/oracle-quickstart/oci-openshift/releasesからAutoscaler Operatorスタックをダウンロードします。最新バージョンのcreate-autoscaler-operatorをダウンロードします。

    ノート

    自動スケーリングで新しいクラスタを作成する場合は、Terraformをダウンロードする必要はありません。

  2. OpenShift RHCOSイメージをダウンロードします。https://mirror.openshift.com/pub/openshift-v4/x86_64/dependencies/rhcos/からイメージを選択します。

    たとえば、OpenShift 4.19.0の場合:

    curl -LO https://mirror.openshift.com/pub/openshift-v4/x86_64/dependencies/rhcos/4.19/4.19.0/rhcos-4.19.0-x86_64-openstack.x86_64.qcow2.gz
gzip -d rhcos-4.19.0-x86_64-openstack.x86_64.qcow2.gz

  3. 「仮想マシン」または「ベア・メタル」を選択します。

    仮想マシンの場合: ダウンロードしたqcow2を直接使用します。

    1. qcow2をObject Storageにアップロードします。
    2. 事前認証済リクエスト・ターゲット: 「オブジェクト」および「アクセス・タイプ」: 「オブジェクト読取りの許可」を使用して、そのオブジェクトの読取りPAR URLを作成します。関連項目: オブジェクト・ストレージでの事前認証済リクエストの作成
    3. TerraformスタックのこのPAR URLを格納します。

    ベア・メタルの場合: iscsi.shシェル・スクリプトを使用して、ダウンロードしたqcow2にiSCSI kargsでパッチを適用します。

    1. https://github.com/oracle-quickstart/oci-openshift/blob/main/assets/autoscaler/iscsi.shからiscsi.shスクリプトをコピーします。
    2. qcow2でスクリプトを実行します。次に例を示します。
      cd /path/to/iscsi.sh
colima ssh
sudo ./iscsi.sh /path/to/rhcos-4.19.0-x86_64-openstack.x86_64.qcow2

    これにより、rhcos-4.19.0-x86_64-openstack.x86_64-iscsi.qcow2が作成されます。

  4. -iscsi.qcow2をObject Storageにアップロードします。
  5. 事前認証済リクエスト・ターゲット: 「オブジェクト」および「アクセス・タイプ」: 「オブジェクト読取りの許可」を使用して、そのオブジェクトの読取りPAR URLを作成します。関連項目: オブジェクト・ストレージでの事前認証済リクエストの作成
  6. TerraformスタックのこのPAR URLを格納します。AssistedまたはAgentベースのインストーラを使用してデプロイメントを構成する場合は、Autoscaler Image Source URIフィールドに貼り付ける必要があります。
  7. Red Hat OpenShift CLI ocをインストールします。最新の手順は、Red Hatのドキュメントを確認してください。たとえば、4.22の場合: https://docs.redhat.com/en/documentation/openshift_container_platform/4.22/html/cli_tools/openshift-cli-oc

ベア・メタル・ワーカー用のRHCOSイメージの準備

  1. RHEL互換の Linuxホストで、必要なパッケージをインストールします。
    sudo dnf install -y qemu-img ostree util-linux
  2. OCI GitHubリポジトリのOpenShiftからiscsi.shをコピーし、実行可能にします。
    chmod +x iscsi.sh
  3. 圧縮されていないRHCOS QCOW2イメージに対してスクリプトを実行します。
    sudo ./iscsi.sh ./rhcos-4.22.0-x86_64-openstack.x86_64.qcow2
  4. 生成された*-iscsi.qcow2イメージをオブジェクト・ストレージにアップロードし、事前認証済リクエストURLを作成します。