6.2. 非接続環境で OpenShift Virtualization に Hosted Control Plane をデプロイする

手順

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 バージョンに置き換えます。