RHV へのインストール

手順

1. RHV Manager マシンでターミナルセッションを開きます。たとえば、Manager をセルフホストエンジンとして実行する場合は、以下を実行します。

   1. RHV Administration Portal (RHV 管理ポータル) に移動し、Compute → Virtual Machines ページに移動します。
   2. HostedEngine 仮想マシンを選択し、Console をクリックします。

2. Manager のコマンドラインで作業ディレクトリーを作成し、そのディレクトリーに切り替えます。

   $ mkdir rhcos
   $ cd rhcos

   Copy to Clipboard Toggle word wrap
3. ブラウザーで、https://github.com/openshift/installer/blob/release-4.4/data/data/rhcos.json に移動します。
4. rhcos.json で、baseURI を見つけ、その値をコピーします。

5. Manager で、wget コマンドを開始し、 baseURI の値を貼り付けます。ただし、Enter は押さないでください。以下に例を示します。

   $ wget https://releases-art-rhcos.svc.ci.openshift.org/art/storage/releases/rhcos-4.4/44.81.202003062006-0/x86_64/

   Copy to Clipboard Toggle word wrap
6. rhcos.json ドキュメントで openstack を見つけ、path の値をコピーします。

7. Manager で path の値を貼り付けます。以下に例を示します。

   $ wget https://releases-art-rhcos.svc.ci.openshift.org/art/storage/releases/rhcos-4.4/44.81.202003062006-0/x86_64/rhcos-44.81.202003062006-0-openstack.x86_64.qcow2.gz

   Copy to Clipboard Toggle word wrap
8. Enter を押して、wget が RHCOS イメージのダウンロードを終了するまで待機します。

9. RHCOS イメージを展開します。以下に例を示します。

   $ gunzip rhcos*

   Copy to Clipboard Toggle word wrap

手順

1. Red Hat Virtualization (RHV) Manager で Ansible Playbook ファイル upload_rhcos_disk.yaml を作成します。以下に例を示します。

   $ vi upload_rhcos_disk.yaml

   Copy to Clipboard Toggle word wrap
2. Red Hat カスタマーポータル上のこのファイル にアクセスします。
3. その内容を Playbook に貼り付けます。

4. Playbook で、コールアウトのあるパラメーター値を更新します。

   - hosts: localhost
     gather_facts: no
     tasks:
       - name: Authenticate with engine
         ovirt_auth:
           url: https://<virtlab.example.com>/ovirt-engine/api 

   1

   
           username: <username@profile> 

   2

   
           password: <password> 

   3

   
           insecure: yes
   
       - name: Upload RHCOS image
         ovirt_disk:
           auth: "{{ ovirt_auth }}"
           name: <rhcos_44-81_img-diskname> 

   4

   
           size: 120GiB 

   5

   
           interface: virtio_scsi
           storage_domain: <SSD_RAID_10> 

   6

   
           bootable: yes
           timeout: 3600 

   7

   
           upload_image_path: </custom/rhcos-44.81.202003110027-0-openstack.x86_64.qcow2> 

   8

   
           wait: yes

   Copy to Clipboard Toggle word wrap

   1

   <virtlab.example.com> に、RHV Manager の完全修飾ドメイン名 (FQDN) を指定します。

   2

   <username@profile> に、管理者ユーザー名およびプロファイルを指定します。

   3

   <password> に、管理者パスワードを指定します。

   4

   <rhcos_44-81_img-diskname> に、ディスク名を指定します。

   5

   実稼働環境に 120GiB 以上を指定します。リソースの制約のある環境または非実稼働環境の場合は、32GiB 以上を指定します。

   6

   <SSD_RAID_10> に、データストレージドメイン名を指定します。

   7

   2.4 GB イメージをストレージにアップロードするのに十分な時間を RHV 環境で確保するためにタイムアウト期間 (秒単位) を指定します。デフォルト値の 3600 秒を指定すると、1 時間が指定されます。

   8

   </custom/rhcos-44.81.202003110027-0-openstack.x86_64.qcow2> には、イメージのパスおよびファイル名を指定します。

5. Manager で Ansible Playbook を実行します。以下に例を示します。

   $ ansible-playbook rhcos_image.yaml -vvv

   Copy to Clipboard Toggle word wrap
6. 管理ポータルで Storage → Disks ページに移動し、Playbook で指定したディスク名を見つけます。例: rhcos_44-81_img-diskname
7. ディスクのステータスが OK の場合は、Playbook は RHCOS イメージのストレージドメインへのアップロードを終了しています。

手順

1. RHV クラスターで利用可能なリソースを確認します。

   1. 次に、RHV 環境の要件の検証 を行います。
   2. ストレージの値 Free Space、Logical CPU Cores、 および Max free Memory for scheduling new VMs を記録します。

2. OpenShift Container Platform クラスター内の仮想マシンの数を記録します。

   • デフォルトで、クラスターには 7 つのマシンが含まれます。
   • RHV のインストール設定パラメーター で説明されているように、マシンの数もカスタマイズできます。ブートストラップマシンに対応できるように 1 つのマシンを設定ファイルの数に追加します。
3. それぞれのリソースを仮想マシン数で割ります。
4. 後に使用できるようにこれらの値を記録します。

手順

1. Compute → Virtual Machines ページに移動し、New をクリックします。
2. New Virtual Machine → 開いている General ウインドウに移動し、Cluster を使用して OpenShift Container Platform クラスターを作成する予定の RHV クラスターを選択します。
3. Template を、 Blank が選択されたままの状態にします。
4. Operating System を Red Hat Enterprise Linux CoreOS に設定します。
5. Optimized for を、 Desktop が選択されたままの状態にします。
6. Name には、仮想マシンの名前を指定します。例: vmname
7. Instance Images で、Attach をクリックします。
8. 開かれている Attach Virtual Disks ウィンドウで、Playbook で指定したディスクを見つけます。例: rhcos_44-81_img-diskname
9. このディスクのラジオボタンをクリックします。
10. このディスクの OS チェックボックスを選択します。これにより、ディスクは起動可能になります。
11. OK をクリックして保存し、Attach Virtual Disks ウィンドウを閉じます。

手順

1. New Virtual Machine → General ウィンドウに移動し、Instantiate VM network interfaces by picking a vNIC profile の下にあるそれぞれの NIC について、vNIC プロファイルを選択します。
2. New Virtual Machine → System ウインドウに移動します。
3. Memory Size を 16384 MB 以上に設定します。このデフォルト値は 16 GiB と同じです。この値は、コンピュートマシンで予想されるワークロードと利用可能なメモリーリソース量に応じて調整できます。
4. 既知の問題 (bz#1821215) があるために、Physical Memory Guaranteed を8192 MB に設定します。この値は 8 GiB に相当します。
5. Total Virtual CPU を 4 以上に設定します。この値は、コンピュートマシンで予想されるワークロードと利用可能なリソースに応じて調整できます。
6. Advanced Parameters を展開します。
7. Cores per Virtual Socket を 4 以上に調整し、Total Virtual CPUs 設定に一致させるようにします。

8. OK を押して保存し、New Virtual Machine を閉じます。

   新しい仮想マシンが Compute → Virtual Machines ウィンドウに表示されます。仮想マシンは起動していないため、これはすぐに表示されます。

手順

1. 新しい仮想マシンを選択します。
2. Administratino Portal ウィンドウの右上にある More actions メニューをクリックし、Make Template を選択します。
3. New Template ウィンドウで、Name の値を指定します。例: vm-tmpltname
4. Target およびその他のパラメーター値が正しいことを確認し、これまでの選択内容を反映させます。
5. Seal Template (Linux only) が選択 されていない ことを確認します。
6. OK をクリックします。
7. Compute → Templates ページに移動し、テンプレートが作成されるまで待機します。

1. 仮想マシン設定の Memory および Total Virtual CPUs に指定した値を確認します。
2. インストールマシンのコマンドラインで、以下の環境変数を実行します。

手順

1. RHV のバージョンを確認します。

   1. RHV Administration Portal の右上にある ? ヘルプアイコンをクリックし、About を選択します。
   2. 開いているウィンドウで、RHV Software Version が 4.3.9 以上であることを確認します。

2. データセンター、クラスター、およびストレージを検査します。

   1. RHV 管理ポータルで、Compute → Data Centers をクリックします。
   2. OpenShift Container Platform をインストールする予定のデータセンターに緑色の上矢印 (Up) が表示されることを確認します。
   3. そのデータセンターの名前をクリックします。
   4. データセンターの詳細の Storage タブで、OpenShift Container Platform をインストールする予定のストレージドメインが Active であることを確認します。
   5. 後で使用できるように ドメイン名 を記録します。
   6. 空き領域 に 230 GiB 以上あることを確認します。
   7. ストレージドメインが これらの etcd バックエンドのパフォーマンス要件 を満たしていることを確認します。これは、fio パフォーマンスベンチマークツールを使用して測定 できます。
   8. データセンターの詳細で、Clusters タブをクリックします。
   9. OpenShift Container Platform をインストールする予定の RHV クラスターを見つけます。後で使用できるようにクラスター名を記録します。

3. RHV ホストリソースを確認します。

   1. RHV 管理ポータルで、Compute > Clusters をクリックします。
   2. OpenShift Container Platform をインストールする予定のクラスターをクリックします。
   3. クラスターの詳細で、Hosts タブをクリックします。
   4. ホストを検査し、それらに OpenShift Container Platform クラスター 専用 として利用可能な 論理 CPU コア の合計が 28 つ以上であることを確認します。
   5. 後で使用できるように、利用可能な 論理 CPU コア の数を記録します。
   6. これらの CPU コアが分散され、インストール時に作成された 7 つの仮想マシンのそれぞれに 4 つのコアを持たせることができることを確認します。

   7. ホストには、以下の OpenShift Container Platform マシンのそれぞれの要件を満たすように 新規仮想マシンをスケジュールするための最大空きメモリー として 112 GiB があることを確認します。

      • ブートストラップマシンに 16 GiB が必要です。
      • 3 つのコントロールプレーンマシンのそれぞれに 16 GiB が必要です。
      • 3 つのコンピュートマシンのそれぞれに 16 GiB が必要です。
   8. 後で使用できるように 新規仮想マシンをスケジュールするための最大空きメモリー の量を記録します。

4. OpenShift Container Platform をインストールするための仮想ネットワークが RHV Manager の REST API にアクセスできることを確認します。このネットワーク上の仮想マシンから、RHV Manager の REST API で curl コマンドを使用します。以下の形式を使用します。

   curl -k -u <username>@<profile>:<password> \ 

   1

   
   https://<engine-fqdn>/ovirt-engine/api 

   2

   Copy to Clipboard Toggle word wrap

   1

   <username> に、RHV 管理者のユーザー名を指定します。<profile> には、ログインプロファイルを指定します。ログインプロファイルは、RHV Administration Portal ログインページに移動し、 Profile ドロップダウンリストで確認できます。<password> に、管理者パスワードを指定します。

   2

   <engine-fqdn> に、RHV 環境の完全修飾ドメイン名を指定します。

   以下に例を示します。

   $ curl -k -u rhvadmin@internal:pw123 \
   https://rhv-env.virtlab.example.com/ovirt-engine/api

   Copy to Clipboard Toggle word wrap

手順

1. 静的 IP アドレスを予約します。

   1. OpenShift Container Platform をインストールするネットワークで、DHCP リースプール外にある 3 つの静的 IP アドレスを特定します。

   2. このネットワーク上のホストに接続し、それぞれの IP アドレスが使用されていないことを確認します。たとえば、Address Resolution Protocol (ARP) を使用して、IP アドレスのいずれにもエントリーがないことを確認します。

      $ arp 10.35.1.19
      10.35.1.19 (10.35.1.19) -- no entry

      Copy to Clipboard Toggle word wrap
   3. ネットワーク環境の標準的な方法に従って、3 つの静的 IP アドレスを予約します。
   4. 今後の参照用にこれらの IP アドレスを記録します。

2. 以下の形式を使用して、OpenShift Container Platform REST API およびアプリケーションドメイン名の DNS エントリーを作成します。

   api.<cluster-name>.<base-domain>   <ip-address> 

   1

   
   *.apps.<cluster-name>.<base-domain>   <ip-address> 

   2

   Copy to Clipboard Toggle word wrap

   1

   <cluster-name>、<base-domain>、および <ip-address> には、クラスター名、ベースドメイン、および OpenShift Container Platform API の静的 IP アドレスを指定します。

   2

   Ingress およびロードバランサー用に OpenShift Container Platform アプリケーションのクラスター名、ベースドメイン、および静的 IP アドレスを指定します。

   以下は例になります。

   api.my-cluster.virtlab.example.com	10.35.1.19
   *.apps.my-cluster.virtlab.example.com	10.35.1.20

   Copy to Clipboard Toggle word wrap
   注記

   3 つ目の静的 IP アドレスには DNS エントリーは必要ありません。OpenShift Container Platform クラスターは、その内部 DNS サービスにこのアドレスを使用します。

手順

1. 以下の 2 つの方法のいずれかを使用して CA 証明書をダウンロードします。

   • Manager の Web ページ (https://<engine-fqdn>/ovirt-engine/) に移動します。次に、Downloads で CA Certificate のリンクをクリックします。

   • 以下のコマンドを実行します。

     $ curl -k 'https://<engine-fqdn>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA' -o /tmp/ca.pem  

     1

     Copy to Clipboard Toggle word wrap

     1

     <engine-fqdn> には、RHV Manager の完全修飾ドメイン名 (例: rhv-env.virtlab.example.com) を指定します。

2. ルートレスユーザーに Manager へのアクセスを付与するように CA ファイルを設定します。CA ファイルのパーミッションを 8 進数の 0644 に設定します (シンボリック値: -rw-r—​r--):

   $ sudo chmod 0644 /tmp/ca.pem

   Copy to Clipboard Toggle word wrap

3. Linux の場合は、サーバー証明書のディレクトリーに CA 証明書をコピーします。-p を使用してパーミッションを保存します。

   $ sudo cp -p /tmp/ca.pem /etc/pki/ca-trust/source/anchors/ca.pem

   Copy to Clipboard Toggle word wrap

4. オペレーティングシステム用の証明書マネージャーに証明書を追加します。

   • MacOS の場合は、証明書ファイルをダブルクリックして、Keychain Access ユーティリティーを使用してファイルを System キーチェーンに追加します。

   • Linux の場合は、CA 信頼を更新します。

     $ sudo update-ca-trust

     Copy to Clipboard Toggle word wrap
     注記

     独自の認証局を使用する場合は、システムがこれを信頼することを確認します。

手順

1. パスワードなしの認証に設定されている SSH キーがコンピューター上にない場合は、これを作成します。たとえば、Linux オペレーティングシステムを使用するコンピューターで以下のコマンドを実行します。

   $ ssh-keygen -t ed25519 -N '' \
       -f <path>/<file_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   ~/.ssh/id_rsa などの、SSH キーのパスおよびファイル名を指定します。既存の SSH キーは上書きされるため、指定しないでください。

   このコマンドを実行すると、指定した場所にパスワードを必要としない SSH キーが生成されます。

2. ssh-agent プロセスをバックグラウンドタスクとして開始します。

   $ eval "$(ssh-agent -s)"
   
   Agent pid 31874

   Copy to Clipboard Toggle word wrap

3. SSH プライベートキーを ssh-agent に追加します。

   $ ssh-add <path>/<file_name> 

   1

   
   
   Identity added: /home/<you>/<path>/<file_name> (<computer_name>)

   Copy to Clipboard Toggle word wrap

   1

   ~/.ssh/id_rsa などの、SSH プライベートキーのパスおよびファイル名を指定します。

手順

1. Red Hat OpenShift Cluster Manager サイトの Infrastructure Provider ページにアクセスします。Red Hat アカウントがある場合は、認証情報を使ってログインします。アカウントがない場合はこれを作成します。

2. 選択するインストールタイプのページに移動し、オペレーティングシステムのインストールプログラムをダウンロードし、ファイルをインストール設定ファイルを保存するディレクトリーに配置します。

   重要

   インストールプログラムは、クラスターのインストールに使用するコンピューターにいくつかのファイルを作成します。クラスターインストールの完了後は、インストールプログラムおよびインストールプログラムが作成するファイルの両方を保持する必要があります。

   重要

   インストールプログラムで作成されたファイルを削除しても、クラスターがインストール時に失敗した場合でもクラスターは削除されません。特定のクラウドプロバイダー用に記載された OpenShift Container Platform のアンインストール手順を完了して、クラスターを完全に削除する必要があります。

3. インストールプログラムを展開します。たとえば、Linux オペレーティングシステムを使用するコンピューターで以下のコマンドを実行します。

   $ tar xvf <installation_program>.tar.gz

   Copy to Clipboard Toggle word wrap
4. Red Hat OpenShift Cluster Manager サイトの Pull Secret ページから、インストールプルシークレットを .txt ファイルとしてダウンロードします。このプルシークレットを使用し、OpenShift Container Platform コンポーネントのコンテナーイメージを提供する Quay.io など、組み込まれた各種の認証局によって提供されるサービスで認証できます。

手順

1. インストールプログラムを実行します。

   $ sudo ./openshift-install create cluster --dir=<installation_directory> \ 

   1

   
       --log-level=info 

   2

   Copy to Clipboard Toggle word wrap

   1

   <installation_directory> の場合、インストールプログラムが作成するファイルを保存するためにディレクトリー名を指定します。

   2

   異なるインストールの詳細情報を表示するには、info ではなく、warn、debug、または error を指定します。

   重要

   空のディレクトリーを指定します。ブートストラップ X.509 証明書などの一部のインストールアセットの有効期限は短く設定されているため、インストールディレクトリーを再利用することができません。別のクラスターインストールの個別のファイルを再利用する必要がある場合は、それらをディレクトリーにコピーすることができます。ただし、インストールアセットのファイル名はリリース間で変更される可能性があります。インストールファイルを以前のバージョンの OpenShift Container Platform からコピーする場合は注意してコピーを行ってください。

   インストールプログラムのプロンプトに対応します。

   1. オプション: SSH Public Key には、 パスワードなしのパブリックキー (例: ~/.ssh/id_rsa.pub) を選択します。このキーは、新規 OpenShift Container Platform クラスターとの接続を認証します。

      注記

      インストールのデバッグまたは障害復旧を実行する必要のある実稼働用の OpenShift Container Platform クラスターには、ssh-agent プロセスが使用する SSH キーを選択します。

   2. Platform には、ovirt を選択します。

   3. Enter oVirt's API endpoint URL に、この形式を使用して RHV API の URL を入力します。

      https://<engine-fqdn>/ovirt-engine/api 

      1

      Copy to Clipboard Toggle word wrap

      1

      <engine-fqdn> に、RHV 環境の完全修飾ドメイン名を指定します。

      以下に例を示します。

      https://rhv-env.virtlab.example.com/ovirt-engine/api

      Copy to Clipboard Toggle word wrap
   4. Is the installed oVirt certificate trusted? には、CA 証明書をすでに設定しているので Yes を入力します。そうでない場合は、No と入力します。
   5. oVirt's CA bundle には、前の質問で Yes を入力している場合には、 /etc/pki/ca-trust/source/anchors/ca.pem の内容をコピーし、ここに貼り付けます。その後、Enter を 2 回押します。そうでない場合、つまり、前の質問で No と入力している場合は、この質問は表示されません。

   6. Enter the oVirt engine username には、この形式を使用して RHV 管理者のユーザー名およびプロファイルを入力します。

      <username>@<profile> 

      1

      Copy to Clipboard Toggle word wrap

      1

      <username> に、RHV 管理者のユーザー名を指定します。<profile> には、ログインプロファイルを指定します。ログインプロファイルは、RHV Administration Portal ログインページに移動し、 Profile ドロップダウンリストで確認できます。ユーザー名とプロファイルは以下のようになります。

      admin@internal

      Copy to Clipboard Toggle word wrap
   7. Enter password に、RHV 管理者パスワードを入力します。
   8. Select the oVirt cluster には、OpenShift Container Platform をインストールするためのクラスターを選択します。
   9. Select the oVirt storage domain には、OpenShift Container Platform をインストールするためのストレージドメインを選択します。
   10. Select the oVirt network には、RHV Manager REST API へのアクセスのある仮想ネットワークを選択します。
   11. Enter the internal API Virtual IP に、クラスターの REST API とは別の静的 IP アドレスを入力します。
   12. Enter the internal DNS Virtual IP には、クラスターの内部 DNS サービスとは別の静的 IP アドレスを入力します。
   13. Enter the ingress IP に、ワイルドカードアプリドメイン用に予約した静的 IP アドレスを入力します。
   14. Base domain に、OpenShift Container Platform クラスターのベースドメインを入力します。このクラスターが外部に公開される場合、これは DNS インフラストラクチャーが認識する有効なドメインである必要があります。例: virtlab.example.com
   15. Cluster name に、クラスターの名前を入力します。例: my-clusterOpenShift Container Platform REST API およびアプリケーションドメイン名向けに作成した外部登録/解決可能な DNS エントリーのクラスター名を使用します。インストールプログラムは、この名前を RHV 環境のクラスターにも指定します。
   16. Pull secret には、先にダウンロードした pull-secret.txt ファイルからプルシークレットをコピーし、ここに貼り付けます。Red Hat OpenShift Cluster Manager サイトの Pull Secret ページから同じプルシークレットのコピーを取得することもできます。
   注記

   ホストに設定した AWS アカウントにクラスターをデプロイするための十分なパーミッションがない場合、インストールプログラムは停止し、不足しているパーミッションが表示されます。

   クラスターのデプロイメントが完了すると、Web コンソールへのリンクや kubeadmin ユーザーの認証情報を含む、クラスターにアクセスするための指示がターミナルに表示されます。

   重要

   インストールプログラムが生成する Ignition 設定ファイルには、24 時間が経過すると期限切れになり、その後に更新される証明書が含まれます。証明書を更新する前にクラスターが停止し、24 時間経過した後にクラスターを再起動すると、クラスターは期限切れの証明書を自動的に復元します。例外として、kubelet 証明書を回復するために保留状態の node-bootstrapper 証明書署名要求 (CSR) を手動で承認する必要があります。詳細は、コントロールプレーン証明書の期限切れの状態からのリカバリー についてのドキュメントを参照してください。

   重要

   インストールプログラム、またはインストールプログラムが作成するファイルを削除することはできません。これらはいずれもクラスターを削除するために必要になります。

手順

1. RHV のバージョンを確認します。

   1. RHV Administration Portal の右上にある ? ヘルプアイコンをクリックし、About を選択します。
   2. 開いているウィンドウで、RHV Software Version が 4.3.9 以上であることを確認します。

2. データセンター、クラスター、およびストレージを検査します。

   1. RHV 管理ポータルで、Compute → Data Centers をクリックします。
   2. OpenShift Container Platform をインストールする予定のデータセンターに緑色の上矢印 (Up) が表示されることを確認します。
   3. そのデータセンターの名前をクリックします。
   4. データセンターの詳細の Storage タブで、OpenShift Container Platform をインストールする予定のストレージドメインが Active であることを確認します。
   5. 後で使用できるように ドメイン名 を記録します。
   6. 空き領域 に 230 GiB 以上あることを確認します。
   7. ストレージドメインが これらの etcd バックエンドのパフォーマンス要件 を満たしていることを確認します。これは、fio パフォーマンスベンチマークツールを使用して測定 できます。
   8. データセンターの詳細で、Clusters タブをクリックします。
   9. OpenShift Container Platform をインストールする予定の RHV クラスターを見つけます。後で使用できるようにクラスター名を記録します。

3. RHV ホストリソースを確認します。

   1. RHV 管理ポータルで、Compute > Clusters をクリックします。
   2. OpenShift Container Platform をインストールする予定のクラスターをクリックします。
   3. クラスターの詳細で、Hosts タブをクリックします。
   4. ホストを検査し、それらに OpenShift Container Platform クラスター 専用 として利用可能な 論理 CPU コア の合計が 28 つ以上であることを確認します。
   5. 後で使用できるように、利用可能な 論理 CPU コア の数を記録します。
   6. これらの CPU コアが分散され、インストール時に作成された 7 つの仮想マシンのそれぞれに 4 つのコアを持たせることができることを確認します。

   7. ホストには、以下の OpenShift Container Platform マシンのそれぞれの要件を満たすように 新規仮想マシンをスケジュールするための最大空きメモリー として 112 GiB があることを確認します。

      • ブートストラップマシンに 16 GiB が必要です。
      • 3 つのコントロールプレーンマシンのそれぞれに 16 GiB が必要です。
      • 3 つのコンピュートマシンのそれぞれに 16 GiB が必要です。
   8. 後で使用できるように 新規仮想マシンをスケジュールするための最大空きメモリー の量を記録します。

4. OpenShift Container Platform をインストールするための仮想ネットワークが RHV Manager の REST API にアクセスできることを確認します。このネットワーク上の仮想マシンから、RHV Manager の REST API で curl コマンドを使用します。以下の形式を使用します。

   curl -k -u <username>@<profile>:<password> \ 

   1

   
   https://<engine-fqdn>/ovirt-engine/api 

   2

   Copy to Clipboard Toggle word wrap

   1

   <username> に、RHV 管理者のユーザー名を指定します。<profile> には、ログインプロファイルを指定します。ログインプロファイルは、RHV Administration Portal ログインページに移動し、 Profile ドロップダウンリストで確認できます。<password> に、管理者パスワードを指定します。

   2

   <engine-fqdn> に、RHV 環境の完全修飾ドメイン名を指定します。

   以下に例を示します。

   $ curl -k -u rhvadmin@internal:pw123 \
   https://rhv-env.virtlab.example.com/ovirt-engine/api

   Copy to Clipboard Toggle word wrap

手順

1. 静的 IP アドレスを予約します。

   1. OpenShift Container Platform をインストールするネットワークで、DHCP リースプール外にある 3 つの静的 IP アドレスを特定します。

   2. このネットワーク上のホストに接続し、それぞれの IP アドレスが使用されていないことを確認します。たとえば、Address Resolution Protocol (ARP) を使用して、IP アドレスのいずれにもエントリーがないことを確認します。

      $ arp 10.35.1.19
      10.35.1.19 (10.35.1.19) -- no entry

      Copy to Clipboard Toggle word wrap
   3. ネットワーク環境の標準的な方法に従って、3 つの静的 IP アドレスを予約します。
   4. 今後の参照用にこれらの IP アドレスを記録します。

2. 以下の形式を使用して、OpenShift Container Platform REST API およびアプリケーションドメイン名の DNS エントリーを作成します。

   api.<cluster-name>.<base-domain>   <ip-address> 

   1

   
   *.apps.<cluster-name>.<base-domain>   <ip-address> 

   2

   Copy to Clipboard Toggle word wrap

   1

   <cluster-name>、<base-domain>、および <ip-address> には、クラスター名、ベースドメイン、および OpenShift Container Platform API の静的 IP アドレスを指定します。

   2

   Ingress およびロードバランサー用に OpenShift Container Platform アプリケーションのクラスター名、ベースドメイン、および静的 IP アドレスを指定します。

   以下は例になります。

   api.my-cluster.virtlab.example.com	10.35.1.19
   *.apps.my-cluster.virtlab.example.com	10.35.1.20

   Copy to Clipboard Toggle word wrap
   注記

   3 つ目の静的 IP アドレスには DNS エントリーは必要ありません。OpenShift Container Platform クラスターは、その内部 DNS サービスにこのアドレスを使用します。

手順

1. 以下の 2 つの方法のいずれかを使用して CA 証明書をダウンロードします。

   • Manager の Web ページ (https://<engine-fqdn>/ovirt-engine/) に移動します。次に、Downloads で CA Certificate のリンクをクリックします。

   • 以下のコマンドを実行します。

     $ curl -k 'https://<engine-fqdn>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA' -o /tmp/ca.pem  

     1

     Copy to Clipboard Toggle word wrap

     1

     <engine-fqdn> には、RHV Manager の完全修飾ドメイン名 (例: rhv-env.virtlab.example.com) を指定します。

2. ルートレスユーザーに Manager へのアクセスを付与するように CA ファイルを設定します。CA ファイルのパーミッションを 8 進数の 0644 に設定します (シンボリック値: -rw-r—​r--):

   $ sudo chmod 0644 /tmp/ca.pem

   Copy to Clipboard Toggle word wrap

3. Linux の場合は、サーバー証明書のディレクトリーに CA 証明書をコピーします。-p を使用してパーミッションを保存します。

   $ sudo cp -p /tmp/ca.pem /etc/pki/ca-trust/source/anchors/ca.pem

   Copy to Clipboard Toggle word wrap

4. オペレーティングシステム用の証明書マネージャーに証明書を追加します。

   • MacOS の場合は、証明書ファイルをダブルクリックして、Keychain Access ユーティリティーを使用してファイルを System キーチェーンに追加します。

   • Linux の場合は、CA 信頼を更新します。

     $ sudo update-ca-trust

     Copy to Clipboard Toggle word wrap
     注記

     独自の認証局を使用する場合は、システムがこれを信頼することを確認します。

手順

1. パスワードなしの認証に設定されている SSH キーがコンピューター上にない場合は、これを作成します。たとえば、Linux オペレーティングシステムを使用するコンピューターで以下のコマンドを実行します。

   $ ssh-keygen -t ed25519 -N '' \
       -f <path>/<file_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   ~/.ssh/id_rsa などの、SSH キーのパスおよびファイル名を指定します。既存の SSH キーは上書きされるため、指定しないでください。

   このコマンドを実行すると、指定した場所にパスワードを必要としない SSH キーが生成されます。

2. ssh-agent プロセスをバックグラウンドタスクとして開始します。

   $ eval "$(ssh-agent -s)"
   
   Agent pid 31874

   Copy to Clipboard Toggle word wrap

3. SSH プライベートキーを ssh-agent に追加します。

   $ ssh-add <path>/<file_name> 

   1

   
   
   Identity added: /home/<you>/<path>/<file_name> (<computer_name>)

   Copy to Clipboard Toggle word wrap

   1

   ~/.ssh/id_rsa などの、SSH プライベートキーのパスおよびファイル名を指定します。

手順

1. Red Hat OpenShift Cluster Manager サイトの Infrastructure Provider ページにアクセスします。Red Hat アカウントがある場合は、認証情報を使ってログインします。アカウントがない場合はこれを作成します。

2. 選択するインストールタイプのページに移動し、オペレーティングシステムのインストールプログラムをダウンロードし、ファイルをインストール設定ファイルを保存するディレクトリーに配置します。

   重要

   インストールプログラムは、クラスターのインストールに使用するコンピューターにいくつかのファイルを作成します。クラスターインストールの完了後は、インストールプログラムおよびインストールプログラムが作成するファイルの両方を保持する必要があります。

   重要

   インストールプログラムで作成されたファイルを削除しても、クラスターがインストール時に失敗した場合でもクラスターは削除されません。特定のクラウドプロバイダー用に記載された OpenShift Container Platform のアンインストール手順を完了して、クラスターを完全に削除する必要があります。

3. インストールプログラムを展開します。たとえば、Linux オペレーティングシステムを使用するコンピューターで以下のコマンドを実行します。

   $ tar xvf <installation_program>.tar.gz

   Copy to Clipboard Toggle word wrap
4. Red Hat OpenShift Cluster Manager サイトの Pull Secret ページから、インストールプルシークレットを .txt ファイルとしてダウンロードします。このプルシークレットを使用し、OpenShift Container Platform コンポーネントのコンテナーイメージを提供する Quay.io など、組み込まれた各種の認証局によって提供されるサービスで認証できます。

手順

1. install-config.yaml ファイルを作成します。

   1. Red Hat Virtualization (RHV) の場合は、sudo でインストールプログラムを実行します。

      $ sudo ./openshift-install create install-config --dir=<installation_directory> 

      1

      Copy to Clipboard Toggle word wrap

      1

      <installation_directory> の場合、インストールプログラムが作成するファイルを保存するためにディレクトリー名を指定します。

      重要

      空のディレクトリーを指定します。ブートストラップ X.509 証明書などの一部のインストールアセットの有効期限は短く設定されているため、インストールディレクトリーを再利用することができません。別のクラスターインストールの個別のファイルを再利用する必要がある場合は、それらをディレクトリーにコピーすることができます。ただし、インストールアセットのファイル名はリリース間で変更される可能性があります。インストールファイルを以前のバージョンの OpenShift Container Platform からコピーする場合は注意してコピーを行ってください。

   2. インストールプログラムのプロンプトに対応します。

      1. SSH Public Key では、パスワードなしのパブリックキー (例: ~/.ssh/id_rsa.pub) を選択します。このキーは、新規 OpenShift Container Platform クラスターとの接続を認証します。

         注記

         インストールのデバッグまたは障害復旧を実行する必要のある実稼働用の OpenShift Container Platform クラスターには、ssh-agent プロセスが使用する SSH キーを選択します。

      2. Platform には、ovirt を選択します。

      3. Enter oVirt's API endpoint URL に、この形式を使用して RHV API の URL を入力します。

         https://<engine-fqdn>/ovirt-engine/api 

         1

         Copy to Clipboard Toggle word wrap

         1

         <engine-fqdn> に、RHV 環境の完全修飾ドメイン名を指定します。

         以下に例を示します。

         https://rhv-env.virtlab.example.com/ovirt-engine/api

         Copy to Clipboard Toggle word wrap
      4. Is the installed oVirt certificate trusted? には、CA 証明書をすでに設定しているので Yes を入力します。そうでない場合は、No と入力します。
      5. oVirt's CA bundle には、前の質問で Yes を入力している場合には、 /etc/pki/ca-trust/source/anchors/ca.pem の内容をコピーし、ここに貼り付けます。その後、Enter を 2 回押します。そうでない場合、つまり、前の質問で No と入力している場合は、この質問は表示されません。

      6. Enter the oVirt engine username には、この形式を使用して RHV 管理者のユーザー名およびプロファイルを入力します。

         <username>@<profile> 

         1

         Copy to Clipboard Toggle word wrap

         1

         <username> に、RHV 管理者のユーザー名を指定します。<profile> には、ログインプロファイルを指定します。ログインプロファイルは、RHV Administration Portal ログインページに移動し、 Profile ドロップダウンリストで確認できます。ユーザー名とプロファイルは以下のようになります。

         admin@internal

         Copy to Clipboard Toggle word wrap
      7. Enter password に、RHV 管理者パスワードを入力します。
      8. Select the oVirt cluster には、OpenShift Container Platform をインストールするためのクラスターを選択します。
      9. Select the oVirt storage domain には、OpenShift Container Platform をインストールするためのストレージドメインを選択します。
      10. Select the oVirt network には、RHV Manager REST API へのアクセスのある仮想ネットワークを選択します。
      11. Enter the internal API Virtual IP に、クラスターの REST API とは別の静的 IP アドレスを入力します。
      12. Enter the internal DNS Virtual IP には、クラスターの内部 DNS サービスとは別の静的 IP アドレスを入力します。
      13. Enter the ingress IP に、ワイルドカードアプリドメイン用に予約した静的 IP アドレスを入力します。
      14. Base domain に、OpenShift Container Platform クラスターのベースドメインを入力します。このクラスターが外部に公開される場合、これは DNS インフラストラクチャーが認識する有効なドメインである必要があります。例: virtlab.example.com
      15. Cluster name に、クラスターの名前を入力します。例: my-clusterOpenShift Container Platform REST API およびアプリケーションドメイン名向けに作成した外部登録/解決可能な DNS エントリーのクラスター名を使用します。インストールプログラムは、この名前を RHV 環境のクラスターにも指定します。
      16. Pull secret には、先にダウンロードした pull-secret.txt ファイルからプルシークレットをコピーし、ここに貼り付けます。Red Hat OpenShift Cluster Manager サイトの Pull Secret ページから同じプルシークレットのコピーを取得することもできます。
2. install-config.yaml ファイルを変更します。利用可能なパラメーターの詳細については、インストール設定パラメーターセクションを参照してください。

3. install-config.yaml ファイルをバックアップし、複数のクラスターをインストールするのに使用できるようにします。

   重要

   install-config.yaml ファイルはインストールプロセス時に使用されます。このファイルを再利用する必要がある場合は、この段階でこれをバックアップしてください。

手順

1. インストールプログラムを実行します。

   $ sudo ./openshift-install create cluster --dir=<installation_directory> \ 

   1

   
       --log-level=info 

   2

   Copy to Clipboard Toggle word wrap

   1

   <installation_directory> には、カスタマイズされた install-config.yaml ファイルの場所を指定します。

   2

   異なるインストールの詳細情報を表示するには、 info ではなく、warn、debug、または error を指定します。

   注記

   ホストに設定した AWS アカウントにクラスターをデプロイするための十分なパーミッションがない場合、インストールプログラムは停止し、不足しているパーミッションが表示されます。

   クラスターのデプロイメントが完了すると、Web コンソールへのリンクや kubeadmin ユーザーの認証情報を含む、クラスターにアクセスするための指示がターミナルに表示されます。

   重要

   インストールプログラムが生成する Ignition 設定ファイルには、24 時間が経過すると期限切れになり、その後に更新される証明書が含まれます。証明書を更新する前にクラスターが停止し、24 時間経過した後にクラスターを再起動すると、クラスターは期限切れの証明書を自動的に復元します。例外として、kubelet 証明書を回復するために保留状態の node-bootstrapper 証明書署名要求 (CSR) を手動で承認する必要があります。詳細は、コントロールプレーン証明書の期限切れの状態からのリカバリー についてのドキュメントを参照してください。

   重要

   インストールプログラム、またはインストールプログラムが作成するファイルを削除することはできません。これらはいずれもクラスターを削除するために必要になります。

手順

1. kubeadmin 認証情報をエクスポートします。

   $ export KUBECONFIG=<installation_directory>/auth/kubeconfig 

   1

   Copy to Clipboard Toggle word wrap

   1

   <installation_directory> には、インストールファイルを保存したディレクトリーへのパスを指定します。

2. エクスポートされた設定を使用して、oc コマンドを正常に実行できることを確認します。

   $ oc whoami
   system:admin

   Copy to Clipboard Toggle word wrap

手順

1. クラスター環境で、管理者の kubeconfig ファイルをエクスポートします。

   $ export KUBECONFIG=<installation_directory>/auth/kubeconfig 

   1

   Copy to Clipboard Toggle word wrap

   1

   <installation_directory> には、インストールファイルを保存したディレクトリーへのパスを指定します。

   kubeconfig ファイルには、クライアントを正しいクラスターおよび API サーバーに接続するために CLI で使用されるクラスターについての情報が含まれます。

2. デプロイメント後に作成されたコントロールプレーンおよびコンピュートマシンを表示します。

   $ oc get nodes

   Copy to Clipboard Toggle word wrap

3. クラスターのバージョンを表示します。

   $ oc get clusterversion

   Copy to Clipboard Toggle word wrap

4. Operator のステータスを表示します。

   $ oc get clusteroperator

   Copy to Clipboard Toggle word wrap

5. クラスター内のすべての実行中の Pod を表示します。

   $ oc get pods -A

   Copy to Clipboard Toggle word wrap

手順

1. オプション: Red Hat Virtualization (RHV) Administration Portal で、Compute → Cluster を開きます。
2. インストールプログラムが仮想マシンを作成することを確認します。
3. インストールプログラムが実行されているコマンドラインに戻ります。インストールプログラムが完了すると、OpenShift Container Platform Web コンソールにログインするためのユーザー名およびパスワードの一時パスワードが表示されます。

4. ブラウザーから OpenShift Container Platform の Web コンソールの URL を開きます。URL は以下の形式を使用します。

   console-openshift-console.apps.<clustername>.<basedomain> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <clustername>.<basedomain> に、クラスター名およびベースドメインを指定します。

   以下に例を示します。

   console-openshift-console.apps.my-cluster.virtlab.example.com

   Copy to Clipboard Toggle word wrap

手順

1. クラスターをインストールするために使用したコンピューターから、以下のコマンドを実行します。

   $ ./openshift-install destroy cluster \
   --dir=<installation_directory> --log-level=info 

   1

   2

   Copy to Clipboard Toggle word wrap

   1

   <installation_directory> には、インストールファイルを保存したディレクトリーへのパスを指定します。

   2

   異なる詳細情報を表示するには、 info ではなく、warn、debug、または error を指定します。

   注記

   クラスターのクラスター定義ファイルが含まれるディレクトリーを指定する必要があります。クラスターを削除するには、インストールプログラムでこのディレクトリーにある metadata.json ファイルが必要になります。

2. オプション: <installation_directory> ディレクトリーおよび OpenShift Container Platform インストールプログラムを削除します。