Harvester Cloud Provider

你可以使用内置的 Harvester 主机驱动在 Rancher 中配置 RKE1 和 RKE2 集群。Harvester 会为这些 Kubernetes 集群提供负载均衡器和集群持久存储支持。

你将在本文中学习：

• 如何在 RKE1 和 RKE2 中部署 Harvester Cloud Provider。
• 如何使用 Harvester 负载均衡器。

部署

前提

• Kubernetes 集群是在 Harvester 虚拟机之上构建的。
• 作为 Kubernetes 节点运行的 Harvester 虚拟机位于相同的命名空间中。

使用 Harvester 主机驱动部署到 RKE1 集群

使用 Harvester 主机驱动启动 RKE 集群时，你可以执行两个步骤来部署 Harvester 云提供商：

• 选择 Harvester(Out-of-tree) 选项。

  

• 从 Rancher 应用市场中安装 Harvester Cloud Provider。

  

备注

你需要指定集群名称。如果未指定集群名称，则会使用默认值 kubernetes。集群名称用来区分 Harvester 负载均衡器的所有权。

• 如有需要，从 Rancher 应用市场中安装 Harvester CSI Driver。

  

使用 Harvester 主机驱动部署到 RKE2 集群[实验功能]

使用 Harvester 主机驱动启动 RKE2 集群时，选择 Harvester 云提供商。然后，主机驱动将自动部署 CSI 驱动和 CCM。

使用 Harvester 主机驱动部署到 K3s 集群[实验性]

• 为 K3s 选择 Kubernetes 版本，并点击 Edit as YAML 按钮，来配置 K3s 集群 YAML（对于现有集群，你也可以点击 Edit YAML 按钮进行更新)：

  

• 编辑 K3s 集群 YAML。

  • 设置 disable-cloud-provider: true 以禁用默认的 K3s 云提供商。

  • 添加 cloud-provider=external 以使用 Harvester 云提供商。

    

• 生成 addon 配置并放入 K3s 虚拟机 /etc/kubernetes/cloud-config。

部署外部云提供商

对于基于 RKE2 和 K3s 的集群而言，部署外部云提供商的步骤是相似的。

按照上述步骤禁用 in-tree 云提供商后，你可以通过以下方式部署外部云提供商：

示例 manifest 如下：

apiVersion: helm.cattle.io/v1
kind: HelmChart
metadata:
  name: harvester-cloud-provider
  namespace: kube-system
spec:
  targetNamespace: kube-system
  bootstrap: true
  repo: https://charts.harvesterhci.io/
  chart: harvester-cloud-provider
  version: 0.1.12
  helmVersion: v3

云提供商需要一个 kubeconfig 文件才能工作，你可以使用 harvester/cloud-provider-harvester 仓库中的 generate_addon.sh 脚本来生成一个有限范围的文件。

注意：脚本需要访问 Harvester 集群 kubeconfig 才能工作。此外，命名空间需要是将在其中创建工作负载集群的命名空间。

# 依赖 kubectl 来操作 Harvester 集群
./deploy/generate_addon.sh <serviceaccount name> <namespace>

输出将如下所示：

(⎈ |local:default)➜  cloud-provider-harvester git:(master) ✗ ./deploy/generate_addon.sh harvester-cloud-provider default
Creating target directory to hold files in ./tmp/kube...done
Creating a service account in default namespace: harvester-cloud-provider
W0506 16:44:15.429068 3008674 helpers.go:598] --dry-run is deprecated and can be replaced with --dry-run=client.
serviceaccount/harvester-cloud-provider configured
Creating a role in default namespace: harvester-cloud-provider
role.rbac.authorization.k8s.io/harvester-cloud-provider unchanged
Creating a rolebinding in default namespace: harvester-cloud-provider
W0506 16:44:23.798293 3008738 helpers.go:598] --dry-run is deprecated and can be replaced with --dry-run=client.
rolebinding.rbac.authorization.k8s.io/harvester-cloud-provider configured
Getting secret of service account harvester-cloud-provider on default
Secret name: harvester-cloud-provider-token-5zkk9
Extracting ca.crt from secret...done
Getting user token from secret...done
Setting current context to: local
Cluster name: local
Endpoint: https://HARVESTER_ENDPOINT/k8s/clusters/local
Preparing k8s-harvester-cloud-provider-default-conf
Setting a cluster entry in kubeconfig...Cluster "local" set.
Setting token credentials entry in kubeconfig...User "harvester-cloud-provider-default-local" set.
Setting a context entry in kubeconfig...Context "harvester-cloud-provider-default-local" created.
Setting the current-context in the kubeconfig file...Switched to context "harvester-cloud-provider-default-local".
########## cloud config ############
apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: CACERT
    server: https://HARVESTER-ENDPOINT/k8s/clusters/local
  name: local
contexts:
- context:
    cluster: local
    namespace: default
    user: harvester-cloud-provider-default-local
  name: harvester-cloud-provider-default-local
current-context: harvester-cloud-provider-default-local
kind: Config
preferences: {}
users:
- name: harvester-cloud-provider-default-local
  user:
    token: TOKEN

现在，你可以通过节点池 Advanced Options 中的 user-data 注入这个 cloud-config 文件：

有了这些设置，K3s/RKE2 集群应该可以在你使用外部云提供商时成功配置。

升级 Cloud Provider

升级 RKE2

你可以通过升级 RKE2 版本来升级 Cloud Provider。要升级 RKE2 集群，你可以在 Rancher UI 中执行以下操作：

1. 单击 ☰ > Cluster Management。
2. 找到要升级的 guest 集群，然后选择 ⋮ > Edit Config。
3. 选择 Kubernetes Version。
4. 单击 Save。

升级 RKE/K3s

你可以通过 Rancher UI 升级 RKE/K3s cloud provider，如下所示：

1. 单击 ☰ > RKE/K3s Cluster > Apps > Installed Apps。
2. 找到 cloud provider 表并选择 ⋮ > Edit/Upgrade。
3. 选择 Version。
4. 单击 Next > Update。

负载均衡器支持

部署 Harvester Cloud Provider 后，你可以使用 Kubernetes LoadBalancer 服务将集群内的微服务公开给外部。在你创建 Kubernetes LoadBalancer 服务时，会为该服务分配一个 Harvester 负载均衡器，你可以通过 Rancher UI 中的 Add-on Config 对其进行编辑。

IPAM

Harvester 的内置负载均衡器同时支持 pool 和 dhcp 模式。你可以在 Rancher UI 中选择模式，随后 Harvester 将注释 cloudprovider.harvesterhci.io/ipam 添加到后面的服务中。

• pool：需要提前在 Harvester 中配置一个 IP 地址池。Harvester LoadBalancer Controller 将从 IP 地址池中为负载均衡器分配一个 IP 地址。

  

• dhcp：需要 DHCP 服务器。Harvester LoadBalancer Controller 将从 DHCP 服务器请求 IP 地址。

备注

不允许修改 IPAM 模式。如果需要修改 IPAM 模式，你需要创建一个新服务。

健康检查

Harvester 负载均衡器支持 TCP 健康检查。如果启用了健康检查选项，你可以在 Rancher UI 中指定参数。

你也可以手动将注释添加到服务来指定参数。支持以下注释：