Oracle Distributed Cloud へのインストール

手順

1. 管理者権限で OCI アカウントにログインします。

2. Accounts and Resources (Oracle ドキュメント) を定義してアカウントを設定します。次のリソースを必ず作成してください。

   1. OCI リソースの整理、アクセスの制限、および使用制限の設定を行うための子コンパートメントを作成します。詳細な手順は、Creating a Compartment (Oracle ドキュメント) を参照してください。
   2. 検出 ISO イメージをアップロードする新しいオブジェクトストレージバケットを作成します。詳細な手順は、Creating an Object Storage Bucket (Oracle ドキュメント) を参照してください。

3. oracle-quickstart/oci-openshift リポジトリーから、create-cluster-vX.X.X.zip 設定ファイルの最新バージョンをダウンロードします。このファイルは、クラスターのインフラストラクチャーを提供するものであり、次の設定を含んでいます。

   • Terraform Stacks: Oracle Distributed Cloud で OpenShift Container Platform クラスターを作成および管理するための OCI リソースをプロビジョニングするための Terraform スタックコード。
   • カスタムマニフェスト: Oracle Distributed Cloud への OpenShift Container Platform クラスターのインストールに必要なマニフェストファイル。
   注記

   マニフェストに変更を加える場合は、Oracle GitHub リポジトリー全体をクローンすると、custom_manifests および terraform-stacks ディレクトリーに直接アクセスできます。

   詳細は、Configuration Files (Oracle ドキュメント) を参照してください。

手順

1. Oracle Distributed Cloud アカウントにログインします。
2. 検出 ISO イメージを、ローカルドライブから、作成した新しいオブジェクトストレージバケットにアップロードします。詳細な手順は、Uploading an Object Storage Object to a Bucket (Oracle ドキュメント) を参照してください。

3. アップロードした検出 ISO を見つけて、次の手順を実行します。

   1. 横にあるオプションメニューから ISO の Pre-Authenticated Request (PAR) を作成します。
   2. 生成された URL をコピーします。これは次のステップで OpenShift Image Source URI として使用します。

   詳細な手順は、Creating a Pre-Authenticated Requests in Object Storage (Oracle ドキュメント) を参照してください。

4. Terraform スタックを作成して適用します。

   重要

   Terraform スタックには、クラスターリソースとカスタムマニフェストを作成するためのファイルが含まれています。このスタックにはスクリプトも含まれており、スタックを適用すると、そのスクリプトによって DNS レコード、インスタンス、その他のリソースといった OCI リソースが作成されます。リソースのリストは、OpenShift on OCI (OSO) の terraform-stacks フォルダーを参照してください。

   1. Terraform スタックテンプレート terraform-stacks を新しいオブジェクトストレージバケットにアップロードします。

   2. スタックの情報を入力し、Next をクリックします。

      重要
      • Cluster Name が Assisted Installer の Cluster Name と一致し、Zone DNS が Assisted Installer の Base Domain と一致していることを確認してください。
      • OpenShift Image Source URI フィールドに、前のステップで生成した Pre-Authenticated Request の URL リンクを貼り付けてください。
      • ベアメタルにインストールするか、仮想マシンにインストールするかに応じて、正しい Compute Shape フィールド値が定義されていることを確認してください。正しくない場合は、リストから別のシェイプを選択してください。詳細は、Compute Shapes (Oracle ドキュメント) を参照してください。
   3. Apply をクリックしてスタックを適用します。

   詳細な手順は、Creating OpenShift Container Platform Infrastructure Using Resource Manager (Oracle ドキュメント) を参照してください。

5. Terraform スタックの Outputs ページから dynamic_custom_manifest.yml ファイルをコピーします。

   注記

   YAML ファイルには、設定値と連結され、事前にフォーマットされた必要なマニフェストがすべて含まれています。詳細は、カスタムマニフェストの README ファイル を参照してください。

   詳細な手順は、Getting the OpenShift Container Platform Custom Manifests for Installation (Oracle ドキュメント) を参照してください。

手順

1. Red Hat Hybrid Cloud Console から、Clusters > Assisted Clusters に移動し、クラスターの名前を選択します。
2. Installation Progress ページで、インストールの進行状況バーが 100% になっており、Installation completed successfully というメッセージが表示されていることを確認します。

3. Host inventory で、すべてのコントロールプレーンとコンピュートノードのステータスが Installed であることを確認します。

   注記

   OpenShift Container Platform は、コントロールプレーンノードの 1 つをブートストラップ仮想マシンとして指定します。そのため、別のブートストラップマシンは不要です。

4. Web コンソール URL をクリックして、OpenShift Container Platform Web コンソールにアクセスします。
5. メニューから、Compute > Nodes を選択します。
6. Nodes テーブルからノードを見つけます。
7. Terminal タブで、シリアル番号の横に iSCSI が表示されていることを確認します。
8. Overview タブで、ノードが Ready ステータスになっていることを確認します。
9. YAML タブを選択します。
10. labels パラメーターを確認し、表示されるラベルが、使用する設定に該当するものであることを確認します。たとえば、topology.kubernetes.io/region=us-sanjose-1 ラベルは、ノードがデプロイされた Oracle Distributed Cloud リージョンを示します。

1. Oracle Cloud Infrastructure (OCI)のリソースおよびサービス(Oracle)を作成します。
2. 非接続環境: OCI インスタンスからアクセスできる Web サーバーを準備します (Red Hat)。
3. Agent-based Installer 用の設定ファイルを準備します (Red Hat)。
4. エージェント ISO イメージを生成します (Red Hat)。
5. 非接続環境: rootfs イメージを Web サーバーにアップロードします (Red Hat)。
6. OpenShift Container Platform のファイアウォールを設定します (Red Hat)。
7. エージェント ISO イメージをストレージバケットにアップロードします (Oracle)。
8. アップロードしたエージェント ISO イメージからカスタムイメージを作成します (Oracle)。
9. Oracle Distributed Cloud (Oracle)で Compute インスタンスを作成します。
10. クラスターが Oracle Distributed Cloud (Oracle)で実行していることを確認します。

手順

1. 次のコマンドを実行して、設定ファイルを保存するインストールディレクトリーを作成します。

   $ mkdir ~/<directory_name>

2. 組織のニーズに合わせて install-config.yaml 設定ファイルを設定し、作成したディレクトリーにファイルを保存します。

   外部プラットフォームを設定する install-config.yaml ファイル

   # install-config.yaml
   apiVersion: v1
   baseDomain: <base_domain> 

   1

   
   networking:
     clusterNetwork:
     - cidr: 10.128.0.0/14
       hostPrefix: 23
     network type: OVNKubernetes
     machineNetwork:
     - cidr: <ip_address_from_cidr> 

   2

   
     serviceNetwork:
     - 172.30.0.0/16
   compute:
     - architecture: amd64 

   3

   
     hyperthreading: Enabled
     name: worker
     replicas: 0
   controlPlane:
     architecture: amd64 

   4

   
     hyperthreading: Enabled
     name: master
     replicas: 3
   platform:
      external:
       platformName: oci 

   5

   
       cloudControllerManager: External
   sshKey: <public_ssh_key> 

   6

   
   pullSecret: '<pull_secret>' 

   7

   
   # ...

   1

   クラウドプロバイダーのベースドメイン。

   2

   ネットワーク上で機能するリソースおよびコンポーネントに対して CIDR が割り当てる仮想クラウドネットワーク (VCN) の IP アドレス。

   3 4

   インフラストラクチャーに応じて、arm64 または amd64 のいずれかを選択できます。

   5

   OpenShift Container Platform が OCI と統合できるように、OCI を外部プラットフォームとして設定します。

   6

   SSH 公開鍵を指定します。

   7

   OpenShift Container Platform コンポーネントおよびサービス (Quay.io など) のコンテナーイメージをダウンロードするときに認証するために必要なプルシークレット。Red Hat Hybrid Cloud Console の Install OpenShift Container Platform 4 を参照してください。

3. ローカルシステム上に openshift という名前のディレクトリーを作成します。これはインストールディレクトリーのサブディレクトリーである必要があります。

   重要

   install-config.yaml または agent-config.yaml 設定ファイルを openshift ディレクトリーに移動しないでください。

4. スタックを使用して OCI インフラストラクチャーリソースをプロビジョニングした場合: OCI スタックの dynamic_custom_manifest 出力をコピーして、manifest.yaml という名前のファイルに貼り付け、そのファイルを openshift ディレクトリーに保存します。

5. スタックを使用して OCI インフラストラクチャーリソースをプロビジョニングしなかった場合: カスタムマニフェストをダウンロードして準備し、エージェント ISO イメージを作成します。

   1. Configuration Files (Oracle ドキュメント) に移動し、GitHub のカスタムマニフェストディレクトリーへのリンクをクリックします。
   2. condensed-manifest.yml ファイルの内容をコピーし、openshift ディレクトリー内のファイルにローカルに保存します。
   3. condensed-manifest.yml ファイルで、TODO でマークされたセクションを更新して、コンパートメントの Oracle® Cloud Identifier (OCID)、VCN の OCID、ロードバランサーからのサブネットの OCID、およびセキュリティーリストの OCID を指定します。

6. 組織の要件に合わせて agent-config.yaml 設定ファイルを設定します。

   IPv4 ネットワーク用のサンプル agent-config.yaml ファイル

   apiVersion: v1beta1
   metadata:
     name: <cluster_name> 

   1

   
     namespace: <cluster_namespace> 

   2

   
   rendezvousIP: <ip_address_from_CIDR> 

   3

   
   bootArtifactsBaseURL: <server_URL> 

   4

   
   # ...

   1

   DNS レコードに指定したクラスター名。

   2

   OpenShift Container Platform 上のクラスターの namespace。

   3

   ネットワーク IP アドレス形式として IPv4 を使用する場合は、rendezvousIP パラメーターを、VCN の Classless Inter-Domain Routing (CIDR) 方式によってネットワークに割り当てられる IPv4 アドレスに必ず設定してください。また、ISO を使用して起動したインスタンスプール内の少なくとも 1 つのインスタンスが、rendezvousIP パラメーターに設定した IP アドレス値と一致していることを確認してください。

   4

   rootfs イメージをアップロードするサーバーの URL。このパラメーターは、非接続環境でのみ必要です。

7. インストールディレクトリーで次のコマンドを入力して、rootfs イメージを除外した最小限の ISO イメージを生成します。

   $ ./openshift-install agent create image --log-level debug

   このコマンドは次の操作も実行します。

   • サブディレクトリー ./<installation_directory>/auth directory: を作成し、そのサブディレクトリーに kubeadmin-password ファイルと kubeconfig ファイルを配置します。
   • agent-config.yaml 設定ファイルで指定した IP アドレスに基づいて、rendezvousIP ファイルを作成します。

   • オプション: agent-config.yaml および install-config.yaml 設定ファイルに加えた変更は、すべてゼロタッチプロビジョニング (ZTP) カスタムリソースにインポートされます。

     重要

     Agent-based Installer は Red Hat Enterprise Linux CoreOS (RHCOS) を使用します。後のステップで説明する rootfs イメージは、オペレーティングシステムの起動、回復、修復に必要です。

8. 非接続環境のみ: rootfs イメージを Web サーバーにアップロードします。

   1. 最小限の ISO イメージを作成したときに生成された ./<installation_directory>/boot-artifacts ディレクトリーに移動します。

   2. 任意の Hypertext Transfer Protocol デーモン (httpd) などの優先 Web サーバーを使用して、agent-config.yaml ファイルの bootArtifactsBaseURL パラメーターに指定された場所に rootfs イメージをアップロードします。

      たとえば、bootArtifactsBaseURL パラメーターに http://192.168.122.20 と指定されている場合、生成された rootfs イメージをこの場所にアップロードして、Agent-based Installer が http://192.168.122.20/agent.x86_64-rootfs.img からイメージにアクセスできるようにします。Agent-based Installer は、外部プラットフォームの最小限の ISO を起動した後、http://192.168.122.20/agent.x86_64-rootfs.img の場所から rootfs イメージをシステムメモリーにダウンロードします。

      注記

      また、Agent-based Installer は、Operator がクラスターのノードを起動するときに rootfs イメージをシステムメモリーにダウンロードするために、bootArtifactsBaseURL の値を最小限の ISO イメージの設定に追加します。

      重要

      1 GB を超える完全な ISO イメージには、rootfs イメージが含まれていることに注意してください。このイメージは、通常 150 MB 未満の最小 ISO イメージよりも大きくなります。

手順

1. ファイアウォールの許可リストに次のレジストリー URL を設定します。

   Expand

   URL	ポート	機能
   registry.redhat.io	443	コアコンテナーイメージを指定します。
   access.redhat.com	443	コンテナークライアントが registry.access.redhat.com から取得したイメージを検証するのに必要な署名ストアをホストします。ファイアウォール環境では、このリソースが許可リストに含まれていることを確認してください。
   registry.access.redhat.com	443	コアコンテナーイメージを含め、Red Hat Ecosystem Catalog に保存されているすべてのコンテナーイメージをホストします。
   quay.io	443	コアコンテナーイメージを指定します。
   cdn.quay.io	443	コアコンテナーイメージを指定します。
   cdn01.quay.io	443	コアコンテナーイメージを指定します。
   cdn02.quay.io	443	コアコンテナーイメージを指定します。
   cdn03.quay.io	443	コアコンテナーイメージを指定します。
   cdn04.quay.io	443	コアコンテナーイメージを指定します。
   cdn05.quay.io	443	コアコンテナーイメージを指定します。
   cdn06.quay.io	443	コアコンテナーイメージを指定します。
   sso.redhat.com	443	https://console.redhat.com サイトは、sso.redhat.com からの認証を使用します。
   icr.io	443	IBM Cloud Pak コンテナーイメージを提供します。このドメインは、IBM Cloud Paks を使用する場合にのみ必要です。
   cp.icr.io	443	IBM Cloud Pak コンテナーイメージを提供します。このドメインは、IBM Cloud Paks を使用する場合にのみ必要です。

   Show more
   • 許可リストでは、cdn.quay.io と cdn0[1-6].quay.io の代わりにワイルドカード *.quay.io を使用できます。
   • ワイルドカード *.access.redhat.com を使用すると、設定を簡素化し、registry.access.redhat.com を含むすべてのサブドメインを許可できます。
   • quay.io などのサイトを許可リストに追加するには、*.quay.io などのワイルドカードエントリーを拒否リストに加えないでください。ほとんどの場合、イメージレジストリーはコンテンツ配信ネットワーク (CDN) を使用してイメージを提供します。ファイアウォールがアクセスをブロックすると、最初のダウンロード要求が cdn01.quay.io などのホスト名にリダイレクトされるときに、イメージのダウンロードが拒否されます。
2. ファイアウォールの許可リストを設定し、ビルドに必要な言語またはフレームワークのリソースを提供するサイトをリストに含めます。

3. Telemetry を無効にしていない場合は、以下の URL へのアクセスを許可して Red Hat Lightspeed にアクセスできるようにする必要があります。

   Expand

   URL	ポート	機能
   cert-api.access.redhat.com	443	Telemetry で必須
   api.access.redhat.com	443	Telemetry で必須
   infogw.api.openshift.com	443	Telemetry で必須
   console.redhat.com	443	Telemetry および insights-operator で必須

   Show more

4. ファイアウォールの許可リストを設定し、次のレジストリー URL をリストに含めます。

   Expand

   URL	ポート	機能
   api.openshift.com	443	クラスタートークンの両方が必要であり、クラスターに更新が利用可能かどうかを確認するために必要です。
   rhcos.mirror.openshift.com	443	Red Hat Enterprise Linux CoreOS (RHCOS) イメージをダウンロードするために必要です。

   Show more

5. ファイアウォールの許可リストを設定し、次の外部 URL をリストに含めます。各リポジトリー URL は OCI コンテナーをホストします。パフォーマンスの問題を軽減するために、イメージをミラーリングするリポジトリーの数をできる限り少なくすることを検討してください。

   Expand

   URL	ポート	機能
   k8s.gcr.io	port	コミュニティーベースのイメージレジストリーのコンテナーイメージをホストする Kubernetes レジストリー。このイメージレジストリーは、カスタム Google Container Registry (GCR) ドメインでホストされています。
   ghcr.io	port	Open Container Initiative イメージを保存および管理できる GitHub イメージレジストリー。プライベート、内部、パブリックパッケージを公開、インストール、削除するには、アクセストークンが必要です。
   storage.googleapis.com	443	リリースイメージ署名のソース。ただし、Cluster Version Operator には単一の機能ソースのみが必要です。
   registry.k8s.io	port	k8s.gcr.io イメージレジストリーを置き換えます。これは、k8s.gcr.io イメージレジストリーが他のプラットフォームやベンダーをサポートしていないためです。

   Show more

手順

1. エージェント ISO イメージを Oracle のデフォルトの Object Storage バケットにアップロードし、エージェント ISO イメージをカスタムイメージとしてこのバケットにインポートします。カスタムイメージが Unified Extensible Firmware Interface (UEFI) モードで起動するように設定されていることを確認します。詳細は、Creating the OpenShift Container Platform ISO Image (Oracle ドキュメント) を参照してください。

2. クラスタートポロジー用に提供されたベースイメージからコンピュートインスタンスを作成します。Creating the OpenShift Container Platform cluster on OCI (Oracle ドキュメント) を参照してください。

   重要

   コンピュートインスタンスを作成する前に、クラスターに十分なメモリーとディスクリソースがあることを確認してください。さらに、少なくとも 1 つのコンピュートインスタンスが、agent-config.yaml ファイルの rendezvousIP に記載されているアドレスと同じ IP アドレスを持っていることを確認してください。