OCI へのインストール

手順

1. 管理者権限を使用して Oracle Cloud Infrastructure (OCI) アカウントにログインします。
2. Oracle リソースからアーカイブファイルをダウンロードします。アーカイブファイルには、クラスターリソースとカスタムマニフェストを作成するためのファイルが含まれています。アーカイブファイルにはスクリプトも含まれており、スクリプトを実行すると、DNS レコードやインスタンスなどの OCI リソースが作成されます。詳細は、Configuration Files (Oracle ドキュメント) を参照してください。

手順

1. Hybrid Cloud Console の Install OpenShift with the Assisted Installer ページから、Assisted Installer の必要な手順をすべて完了して検出 ISO イメージを生成します。

   1. Cluster Details ステップで、次のフィールドに値を入力します。

      フィールド	必要な操作
      Cluster name	クラスターの名前 (ocidemo など) を指定します。
      Base domain	クラスターのベースドメイン (splat-oci.devcluster.openshift.com など) を指定します。以前に OCI でコンパートメントを作成している場合は、DNS management → Zones → List scope に移動し、親コンパートメントを選択することで、この情報を取得できます。ベースドメインが Public zones タブに表示されます。
      OpenShift version	OpenShift 4.15 以降のバージョンを指定します。
      CPU architecture	x86_64 または Arm64 を指定します。
      Integrate with external partner platforms	Oracle Cloud Infrastructure を指定します。 この値を指定すると、デフォルトで Include custom manifests チェックボックスが選択されます。

   2. Operators ページで、Next をクリックします。
   3. Host Discovery ページで、Add hosts をクリックします。

   4. SSH public key フィールドに、ローカルシステムから SSH キーを追加します。

      ヒント

      ssh-keygen ツールを使用して、SSH 認証キーペアを作成できます。

   5. Generate Discovery ISO をクリックして、検出 ISO イメージファイルを生成します。
   6. ローカルシステムにファイルをダウンロードします。

2. 検出 ISO イメージを OCI バケットにアップロードします。Uploading an Object Storage Object to a Bucket (Oracle ドキュメント) を参照してください。

   1. アップロードされた検出 ISO イメージに対して、事前認証されたリクエストを作成する必要があります。後で OCI スタックを作成するときに URL を指定する必要があるため、事前認証されたリクエストの URL を必ずメモしておいてください。

手順

1. OpenShift Container Platform クラスターの OCI インフラストラクチャーをプロビジョニングする手順を完了します。Creating OpenShift Container Platform Infrastructure Using Resource Manager (Oracle ドキュメント) を参照してください。
2. スタックを作成し、Editing the OpenShift Custom Manifests (Oracle ドキュメント) の手順に従ってカスタムマニフェストファイルを編集します。

手順

1. Red Hat Hybrid Cloud Console Web コンソールから、Host discovery ページに移動します。

2. Role 列で、対象のホスト名ごとに Control plane node または Worker を選択します。

   重要

   次のステップに進む前に、各ノードが Ready ステータスに達するまで待ちます。

3. Storage ステップと Networking ステップのデフォルト設定を受け入れ、Next をクリックします。

4. Custom manifests ページの Folder フィールドで、manifest を選択します。これは、カスタムマニフェストファイルを保存する Assisted Installer 用のフォルダーです。

   1. File name フィールドに、oci-ccm.yml などの値を入力します。
   2. Content セクションで Browse をクリックし、custom_manifest/manifests/oci-ccm.yml にあるドライブから CCM マニフェストを選択します。

5. 次の Custom manifest セクションを展開し、以下のマニフェストに対して同じ手順を繰り返します。

   • CSI ドライバーマニフェスト: custom_manifest/manifests/oci-csi.yml
   • CCM マシン設定: custom_manifest/openshift/machineconfig-ccm.yml
   • CSI ドライバーマシン設定: custom_manifest/openshift/machineconfig-csi.yml
6. Review and create ページで、Install cluster をクリックして、OCI 上に OpenShift Container Platform クラスターを作成します。

手順

1. Hybrid Cloud Console から Clusters > Assisted Clusters に移動し、クラスターの名前を選択します。
2. インストールの進行状況バーが 100% になっていて、“Installation completed successfully” というメッセージが表示されていることを確認します。
3. OpenShift Container Platform Web コンソールにアクセスするために、表示される Web コンソール URL をクリックします。
4. Nodes メニューページに移動します。
5. Nodes テーブルからノードを見つけます。
6. Overview タブで、ノードが Ready ステータスになっていることを確認します。
7. YAML タブを選択します。
8. labels パラメーターを確認し、表示されるラベルが、使用する設定に該当するものであることを確認します。たとえば、topology.kubernetes.io/region=us-sanjose-1 というラベルからは、ノードがデプロイされた OCI リージョンがわかります。

手順

1. 非接続環境の場合は、Red Hat OpenShift のミラーレジストリーをローカルコンテナーイメージレジストリーにミラーリングします。

   重要

   openshift-install バイナリーのバージョンが、Red Hat Quay などの共有レジストリーではなく、ローカルイメージコンテナーレジストリーに関連していることを確認してください。

   $ ./openshift-install version

   共有レジストリーバイナリーの出力例

   ./openshift-install 4.15.0
   built from commit ae7977b7d1ca908674a0d45c5c243c766fa4b2ca
   release image registry.ci.openshift.org/origin/release:4.15ocp-release@sha256:0da6316466d60a3a4535d5fed3589feb0391989982fba59d47d4c729912d6363
   release architecture amd64

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

   インフラストラクチャーに応じて、x86_64 または 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. Oracle ドキュメントの "Configuration Files" セクションの手順を完了して、Oracle Cloud Controller Manager (CCM) および Oracle Container Storage Interface (CSI) マニフェストをアーカイブファイルとしてダウンロードし、アーカイブファイルを openshift ディレクトリーに保存します。OpenShift Container Platform が外部 OCI プラットフォームに接続できるように、クラスターのインストール中に Oracle CCM をデプロイするために Oracle CCM マニフェストが必要です。OpenShift Container Platform が OCI から必要なオブジェクトを要求できるように、クラスターのインストール中に Oracle CSI ドライバーをデプロイするために Oracle CSI カスタムマニフェストが必要です。

5. Oracle ドキュメントの "Configuration Files" セクションで提供されているカスタムマニフェストファイルにアクセスします。

   1. oci-ccm.yml 設定ファイルで定義されている oci-cloud-controller-manager シークレットを、組織のリージョン、コンパートメント OCID、VCN OCID、およびロードバランサーのサブネット OCID と一致するように変更します。

6. OpenShift Container Platform CLI で次のコマンドを入力し、Agent-based Installer を使用して、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 イメージは、オペレーティングシステムの起動、復旧、修復に必要です。

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

   IPv4 形式のネットワークの値を設定する agent-config.yaml 設定ファイルの例

   apiVersion: v1alpha1
   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。

8. 次のどちらかの更新を、agent-config.yaml 設定ファイルに適用します。

   • 非接続ネットワークの場合: コマンドを実行して最小限の ISO イメージを生成すると、Agent-based Installer によって rootfs イメージがローカルシステムの ./<installation_directory>/boot-artifacts ディレクトリーに保存されます。任意の 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 イメージの設定に追加します。

   • 接続されたネットワークの場合: agent-config.yaml 設定ファイルで bootArtifactsBaseURL パラメーターを指定する必要はありません。Agent-based Installer のデフォルトの動作で、https://rhcos.mirror.openshift.com から rootfs URL の場所を読み取ります。Agent-based Installer は、外部プラットフォームの最小限の ISO を起動した後、デフォルトの RHCOS URL から rootfs ファイルをシステムのメモリーにダウンロードします。

     重要

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

手順

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

   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 からの認証を使用します。

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

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

   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 で必須

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

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

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

   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 イメージレジストリーが他のプラットフォームやベンダーをサポートしていないためです。

手順

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 アドレスを持っていることを確認してください。