4.3. 在 OpenShift Virtualization 上部署托管的 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

   Copy to Clipboard Toggle word wrap

   1

   指定托管集群的名称，如 my-hosted-cluster。

   2

   指定节点池副本数，例如 3。您必须将副本数指定为 0 或更高，才能创建相同数量的副本。否则，不会创建节点池。

   3

   指定 pull secret 的路径，例如 /user/name/pullsecret。

   4

   为 memory 指定一个值，如 6Gi。

   5

   为 CPU 指定一个值，例如 2。

   6

   指定 etcd 存储类名称，如 lvm-storageclass。

   注意

   您可以使用 --release-image 标志使用特定的 OpenShift Container Platform 发行版本设置托管集群。

   根据 --node-pool-replicas 标志，为集群创建具有两个虚拟机 worker 副本的集群的默认节点池。

2. 片刻后，输入以下命令验证托管的 control plane pod 是否正在运行：

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

   Copy to Clipboard Toggle word wrap

   输出示例

   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

   Copy to Clipboard Toggle word wrap

   具有 KubeVirt 虚拟机支持的 worker 节点托管的集群通常需要 10-15 分钟才能被完全置备。

流程

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 页中，pull secret 是用于访问 OpenShift Container Platform 资源的 OpenShift Container Platform pull secret。如果选择了 OpenShift Virtualization 凭证，则会自动填充 pull secret。

6. 在 Node pool 页中，展开 Networking options 部分，并配置节点池的网络选项：

   1. 在 Additional networks 字段中，以 <namespace>/<name> 格式输入一个网络名称；例如，my-namespace/network1。命名空间和名称必须是有效的 DNS 标签。支持多个网络。
   2. 默认情况下会选择 Attach default pod network 复选框。只有存在额外网络时，才能清除此复选框。

7. 检查您的条目并点 Create。

   此时会显示 Hosted 集群视图。

8. 在托管集群视图中监控托管集群的部署。如果您没有看到托管集群的信息，请确保选择了 All Clusters，然后点集群名称。
9. 等待 control plane 组件就绪。这个过程可能需要几分钟时间。
10. 要查看节点池状态，请滚动到 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

   Copy to Clipboard Toggle word wrap

   1

   指定托管集群的名称。

   2

   指定 worker 数，如 2。

   3

   指定 pull secret 的路径，例如 /user/name/pullsecret。

   4

   为 memory 指定一个值，如 6Gi。

   5

   为 CPU 指定一个值，例如 2。

   6

   指定基域，如 hypershift.lab。

   因此，托管集群有一个入口通配符，它被配置为集群名称和基域，如 .apps.example.hypershift.lab。托管的集群处于 Partial 状态，因为在创建具有唯一基域的托管集群后，您必须配置所需的 DNS 记录和负载均衡器。

2. 输入以下命令来查看托管集群的状态：

   $ oc get --namespace clusters hostedclusters

   Copy to Clipboard Toggle word wrap

   输出示例

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

   Copy to Clipboard Toggle word wrap

3. 输入以下命令访问集群：

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   输出示例

   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)

   Copy to Clipboard Toggle word wrap

   将 <4.x.0> 替换为您要使用支持的 OpenShift Container Platform 版本。

流程

1. 公开托管集群入口的 NodePort 服务已存在。您可以导出节点端口并创建以这些端口为目标的负载均衡器服务。

   1. 输入以下命令来获取 HTTP 节点端口：

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

      Copy to Clipboard Toggle word wrap

      请注意在下一步中要使用的 HTTP 节点端口值。

   2. 输入以下命令来获取 HTTPS 节点端口：

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

      Copy to Clipboard Toggle word wrap

      请注意下一步要使用的 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

   Copy to Clipboard Toggle word wrap

   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}'

   Copy to Clipboard Toggle word wrap

   输出示例

   192.168.20.30

   Copy to Clipboard Toggle word wrap

2. 配置引用外部 IP 地址的通配符 DNS 条目。查看以下示例 DNS 条目：

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

   Copy to Clipboard Toggle word wrap

   DNS 条目必须能够在集群内部和外部路由。

   DNS 解析示例

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

   Copy to Clipboard Toggle word wrap

3. 输入以下命令检查托管集群状态是否已从 Partial 变为 Completed ：

   $ oc get --namespace clusters hostedclusters

   Copy to Clipboard Toggle word wrap

   输出示例

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

   Copy to Clipboard Toggle word wrap

   将 <4.x.0> 替换为您要使用支持的 OpenShift Container Platform 版本。

流程

1. 要创建节点池，请输入以下信息：在本例中，节点池会将更多 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

   Copy to Clipboard Toggle word wrap

2. 通过列出 cluster 命名空间中的 nodepool 资源来检查节点池的状态：

   $ oc get nodepools --namespace clusters

   Copy to Clipboard Toggle word wrap

   输出示例

   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

   Copy to Clipboard Toggle word wrap

   将 <4.x.0> 替换为您要使用支持的 OpenShift Container Platform 版本。

3. 一段时间后，您可以输入以下命令来检查节点池的状态：

   $ oc --kubeconfig $CLUSTER_NAME-kubeconfig get nodes

   Copy to Clipboard Toggle word wrap

   输出示例

   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

   Copy to Clipboard Toggle word wrap

4. 输入以下命令验证节点池是否处于您期望的状态：

   $ oc get nodepools --namespace clusters

   Copy to Clipboard Toggle word wrap

   输出示例

   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>

   Copy to Clipboard Toggle word wrap

   将 <4.x.0> 替换为您要使用支持的 OpenShift Container Platform 版本。