4.3. OpenShift Virtualization への Hosted Control Plane のデプロイ

手順

1. 次のコマンドを入力して、KubeVirt プラットフォームでホステッドクラスターを作成します。

   $ hcp create cluster kubevirt \
     --name <hosted_cluster_name> \1
     --node-pool-replicas <node_pool_replica_count> \2
     --pull-secret <path_to_pull_secret> \3
     --memory <value_for_memory> \4
     --cores <value_for_cpu> \5
     --etcd-storage-class=<etcd_storage_class> 6

   1

   ホステッドクラスターの名前を指定します (例: example)。

   2

   ノードプールのレプリカ数を指定します (例: 3)。同じ数のレプリカを作成するには、レプリカ数を 0 以上に指定する必要があります。それ以外の場合、ノードプールは作成されません。

   3

   プルシークレットへのパスを指定します (例: /user/name/pullsecret)。

   4

   メモリーの値を指定します (例: 6Gi)。

   5

   CPU の値を指定します (例: 2)。

   6

   etcd ストレージクラス名を指定します (例: lvm-storageclass)。

   注記

   --release-image フラグを使用すると、特定の OpenShift Container Platform リリースを使用してホステッドクラスターを設定できます。

   --node-pool-replicas フラグに従って、2 つの仮想マシンワーカーレプリカを持つクラスターに対してデフォルトのノードプールが作成されます。

2. しばらくすると、次のコマンドを入力して、ホストされているコントロールプレーン Pod が実行されていることを確認できます。

   $ oc -n clusters-<hosted-cluster-name> get pods

   出力例

   NAME                                                  READY   STATUS    RESTARTS   AGE
   capi-provider-5cc7b74f47-n5gkr                        1/1     Running   0          3m
   catalog-operator-5f799567b7-fd6jw                     2/2     Running   0          69s
   certified-operators-catalog-784b9899f9-mrp6p          1/1     Running   0          66s
   cluster-api-6bbc867966-l4dwl                          1/1     Running   0          66s
   .
   .
   .
   redhat-operators-catalog-9d5fd4d44-z8qqk              1/1     Running   0          66s

   KubeVirt 仮想マシンによってサポートされるワーカーノードを含むホステッドクラスターは、通常、完全にプロビジョニングされるまでに 10 ~ 15 分かかります。

3. ホステッドクラスターのステータスを確認するには、次のコマンドを入力して、対応する HostedCluster リソースを確認します。

   $ oc get --namespace clusters hostedclusters

   完全にプロビジョニングされた HostedCluster オブジェクトを示す以下の出力例を参照してください。

   NAMESPACE   NAME      VERSION   KUBECONFIG                 PROGRESS    AVAILABLE   PROGRESSING   MESSAGE
   clusters    example   <4.x.0>     example-admin-kubeconfig   Completed   True        False         The hosted control plane is available

   <4.x.0> を、使用するサポート対象の OpenShift Container Platform バージョンに置き換えます。

手順

1. OpenShift Container Platform Web コンソールを開き、管理者の認証情報を入力してログインします。
2. コンソールヘッダーで、All Clusters が選択されていることを確認します。
3. Infrastructure > Clusters をクリックします。
4. Create cluster > Red Hat OpenShift Virtualization > Hosted をクリックします。

5. Create cluster ページで、プロンプトに従ってクラスターとノードプールの詳細を入力します。

   注記
   • 事前定義された値を使用してコンソールのフィールドに自動的に入力する場合は、OpenShift Virtualization の認証情報を作成します。詳細は、オンプレミス環境の認証情報の作成 を参照してください。
   • Cluster details ページのプルシークレットは、OpenShift Container Platform リソースへのアクセスに使用する OpenShift Container Platform プルシークレットです。OpenShift Virtualization の認証情報を選択した場合、プルシークレットが自動的に入力されます。

6. エントリーを確認し、Create をクリックします。

   Hosted cluster ビューが表示されます。

7. Hosted cluster ビューでホストされたクラスターのデプロイメントを監視します。ホストされたクラスターに関する情報が表示されない場合は、All Clusters が選択されていることを確認し、クラスター名をクリックします。
8. コントロールプレーンコンポーネントの準備が整うまで待ちます。このプロセスには数分かかる場合があります。
9. ノードプールのステータスを表示するには、NodePool セクションまでスクロールします。ノードをインストールするプロセスには約 10 分かかります。Nodes をクリックして、ノードがホストされたクラスターに参加したかどうかを確認することもできます。

手順

1. 以下のコマンドを入力します。

   $ hcp create cluster kubevirt \
     --name <hosted_cluster_name> \ 1
     --node-pool-replicas <worker_count> \ 2
     --pull-secret <path_to_pull_secret> \ 3
     --memory <value_for_memory> \ 4
     --cores <value_for_cpu> \ 5
     --base-domain <basedomain> 6

   1

   ホステッドクラスターの名前を指定します。

   2

   ワーカー数を指定します (例: 2)。

   3

   プルシークレットへのパスを指定します (例: /user/name/pullsecret)。

   4

   メモリーの値を指定します (例: 6Gi)。

   5

   CPU の値を指定します (例: 2)。

   6

   ベースドメインを指定します (例: hypershift.lab)。

   その結果、ホストされたクラスターには、クラスター名とベースドメイン用に設定された Ingress ワイルドカード (例: .apps.example.hypershift.lab) が含まれます。ホステッドクラスターは Partial ステータスのままです。一意のベースドメインを持つホステッドクラスターを作成した後、必要な DNS レコードとロードバランサーを設定する必要があるためです。

2. 次のコマンドを入力して、ホストされたクラスターのステータスを表示します。

   $ oc get --namespace clusters hostedclusters

   出力例

   NAME            VERSION   KUBECONFIG                       PROGRESS   AVAILABLE   PROGRESSING   MESSAGE
   example                   example-admin-kubeconfig         Partial    True        False         The hosted control plane is available

3. 次のコマンドを入力してクラスターにアクセスします。

   $ hcp create kubeconfig --name <hosted_cluster_name> > <hosted_cluster_name>-kubeconfig

   $ oc --kubeconfig <hosted_cluster_name>-kubeconfig get co

   出力例

   NAME                                       VERSION   AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
   console                                    <4.x.0>     False       False         False      30m     RouteHealthAvailable: failed to GET route (https://console-openshift-console.apps.example.hypershift.lab): Get "https://console-openshift-console.apps.example.hypershift.lab": dial tcp: lookup console-openshift-console.apps.example.hypershift.lab on 172.31.0.10:53: no such host
   ingress                                    <4.x.0>     True        False         True       28m     The "default" ingress controller reports Degraded=True: DegradedConditions: One or more other status conditions indicate a degraded state: CanaryChecksSucceeding=False (CanaryChecksRepetitiveFailures: Canary route checks for the default ingress controller are failing)

   <4.x.0> を、使用するサポート対象の OpenShift Container Platform バージョンに置き換えます。

手順

1. ホストされたクラスターの Ingress を公開する NodePort サービスがすでに存在します。ノードポートをエクスポートし、それらのポートをターゲットとするロードバランサーサービスを作成できます。

   1. 次のコマンドを入力して、HTTP ノードポートを取得します。

      $ oc --kubeconfig <hosted_cluster_name>-kubeconfig get services -n openshift-ingress router-nodeport-default -o jsonpath='{.spec.ports[?(@.name=="http")].nodePort}'

      次の手順で使用する HTTP ノードポート値をメモします。

   2. 次のコマンドを入力して、HTTPS ノードポートを取得します。

      $ oc --kubeconfig <hosted_cluster_name>-kubeconfig get services -n openshift-ingress router-nodeport-default -o jsonpath='{.spec.ports[?(@.name=="https")].nodePort}'

      次の手順で使用する HTTPS ノードポート値をメモします。

2. 次のコマンドを入力して、ロードバランサーサービスを作成します。

   oc apply -f -
   apiVersion: v1
   kind: Service
   metadata:
     labels:
       app: <hosted_cluster_name>
     name: <hosted_cluster_name>-apps
     namespace: clusters-<hosted_cluster_name>
   spec:
     ports:
     - name: https-443
       port: 443
       protocol: TCP
       targetPort: <https_node_port> 1
     - name: http-80
       port: 80
       protocol: TCP
       targetPort: <http-node-port> 2
     selector:
       kubevirt.io: virt-launcher
     type: LoadBalancer

   1

   前の手順でメモした HTTPS ノードポート値を指定します。

   2

   前の手順でメモした HTTP ノードポート値を指定します。

手順

1. 次のコマンドを入力して外部 IP アドレスを取得します。

   $ oc -n clusters-<hosted_cluster_name> get service <hosted-cluster-name>-apps -o jsonpath='{.status.loadBalancer.ingress[0].ip}'

   出力例

   192.168.20.30

2. 外部 IP アドレスを参照するワイルドカード DNS エントリーを設定します。次の DNS エントリーの例を表示します。

   *.apps.<hosted_cluster_name\>.<base_domain\>.

   DNS エントリーは、クラスターの内部と外部にルーティングできる必要があります。

   DNS 解決の例

   dig +short test.apps.example.hypershift.lab
   
   192.168.20.30

3. 次のコマンドを実行して、ホストされたクラスターのステータスが Partial から Completed に移行したことを確認します。

   $ oc get --namespace clusters hostedclusters

   出力例

   NAME            VERSION   KUBECONFIG                       PROGRESS    AVAILABLE   PROGRESSING   MESSAGE
   example         <4.x.0>     example-admin-kubeconfig         Completed   True        False         The hosted control plane is available

   <4.x.0> を、使用するサポート対象の OpenShift Container Platform バージョンに置き換えます。

手順

1. ノードプールを作成するには、次の情報を入力します。この例では、ノードプールには VM に割り当てられたより多くの CPU があります。

   export NODEPOOL_NAME=${CLUSTER_NAME}-extra-cpu
   export WORKER_COUNT="2"
   export MEM="6Gi"
   export CPU="4"
   export DISK="16"
   
   $ hcp create nodepool kubevirt \
     --cluster-name $CLUSTER_NAME \
     --name $NODEPOOL_NAME \
     --node-count $WORKER_COUNT \
     --memory $MEM \
     --cores $CPU \
     --root-volume-size $DISK

2. clusters namespace 内の nodepool リソースをリスト表示して、ノードプールのステータスを確認します。

   $ oc get nodepools --namespace clusters

   出力例

   NAME                      CLUSTER         DESIRED NODES   CURRENT NODES   AUTOSCALING   AUTOREPAIR   VERSION   UPDATINGVERSION   UPDATINGCONFIG   MESSAGE
   example                   example         5               5               False         False        <4.x.0>
   example-extra-cpu         example         2                               False         False                  True              True             Minimum availability requires 2 replicas, current 0 available

   <4.x.0> を、使用するサポート対象の OpenShift Container Platform バージョンに置き換えます。

3. しばらくしてから、次のコマンドを入力してノードプールのステータスを確認できます。

   $ oc --kubeconfig $CLUSTER_NAME-kubeconfig get nodes

   出力例

   NAME                      STATUS   ROLES    AGE     VERSION
   example-9jvnf             Ready    worker   97s     v1.27.4+18eadca
   example-n6prw             Ready    worker   116m    v1.27.4+18eadca
   example-nc6g4             Ready    worker   117m    v1.27.4+18eadca
   example-thp29             Ready    worker   4m17s   v1.27.4+18eadca
   example-twxns             Ready    worker   88s     v1.27.4+18eadca
   example-extra-cpu-zh9l5   Ready    worker   2m6s    v1.27.4+18eadca
   example-extra-cpu-zr8mj   Ready    worker   102s    v1.27.4+18eadca

4. 次のコマンドを入力して、ノードプールが予期したステータスになっていることを確認します。

   $ oc get nodepools --namespace clusters

   出力例

   NAME                      CLUSTER         DESIRED NODES   CURRENT NODES   AUTOSCALING   AUTOREPAIR   VERSION   UPDATINGVERSION   UPDATINGCONFIG   MESSAGE
   example                   example         5               5               False         False        <4.x.0>
   example-extra-cpu         example         2               2               False         False        <4.x.0>

   <4.x.0> を、使用するサポート対象の OpenShift Container Platform バージョンに置き換えます。