Oracle Cloud Infrastructureドキュメント

前提条件

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

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

追加リソース

次のものも必要です。
  1. OCIのクラスタ・リソースで実行されるOpenShiftコンテナ・プラットフォーム・コンソールを提供するインターネット・ドメイン。
  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ファイルを生成します。

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

他の前提条件に加えて、自動スケーリング・スタックを作成する場合は、スタックTerraformをダウンロードし(既存のクラスタに自動スケーリングを追加する場合)、自動スケーリングRedHat Linux CoreOS (RHCOS)ソース・イメージを準備して、事前認証済リクエスト(PAR) URLを取得する必要があります。RedHat 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. RedHat OpenShift CLI ocをインストールします。最新の手順は、RedHatのドキュメントを参照してください。たとえば、4.22の場合: https://docs.redhat.com/en/documentation/openshift_container_platform/4.22/html/cli_tools/openshift-cli-oc