设置

本文将介绍可在 Harvester 中使用的高级配置。 你可以从仪表盘 UI 或使用 kubectl 命令修改 settings.harvesterhci.io 自定义资源。

additional-ca

为 Harvester 配置其他受信 CA 证书来访问外部服务。

默认值：none

示例

  1. -----BEGIN CERTIFICATE-----
  2. SOME-CA-CERTIFICATES
  3. -----END CERTIFICATE-----

设置 - 图1警告

更改此设置可能会导致单节点集群产生较短的停机时间。

auto-disk-provision-paths [实验功能]

此设置允许 Harvester 自动添加符合给定 glob 模式的磁盘作为虚拟机存储。 你可以使用逗号分隔来提供多个模式。

设置 - 图2警告

  • 此设置应用于集群中的每个节点。
  • 这些设备中的所有数据都会被销毁。请谨慎使用。

默认值：none

示例

以下示例添加符合 glob 模式 /dev/sd* 或 /dev/hd* 的磁盘：

  1. /dev/sd*,/dev/hd*

backup-target

设置自定义备份目标来存储虚拟机备份。支持 NFS 和 S3。 详情请参见 Longhorn 文档。

默认值：none

示例

  1. {
  2.   "type": "s3",
  3.   "endpoint": "https://s3.endpoint.svc",
  4.   "accessKeyId": "test-access-key-id",
  5.   "secretAccessKey": "test-access-key",
  6.   "bucketName": "test-bup",
  7.   "bucketRegion": "us‑east‑2",
  8.   "cert": "",
  9.   "virtualHostedStyle": false
  10. }

cluster-registration-url

将 Harvester 集群导入 Rancher 以进行多集群管理。

默认值：none

示例

  1. https://172.16.0.1/v3/import/w6tp7dgwjj549l88pr7xmxb4x6m54v5kcplvhbp9vv2wzqrrjhrc7c_c-m-zxbbbck9.yaml

containerd-registry

此设置允许你为 Harvester 集群配置私有镜像仓库。你需要在每个节点的 /etc/rancher/rke2/registries.yaml 中设置参数的值。有关更多信息，请参阅 RKE2 - Containerd 容器镜像仓库配置。

设置 - 图3备注

如果你为私有镜像仓库设置了用户名和密码，系统会先将其保存到 registries.yaml 中，然后再自动删除它们以保护凭证。

示例

containerd-registry

  1. {
  2.   "Mirrors": {
  3.     "docker.io": {
  4.       "Endpoints": ["https://myregistry.local:5000"],
  5.       "Rewrites": null
  6.     }
  7.   },
  8.   "Configs": {
  9.     "myregistry.local:5000": {
  10.       "Auth": {
  11.         "Username": "testuser",
  12.         "Password": "testpassword"
  13.       },
  14.       "TLS": {
  15.         "InsecureSkipVerify": false
  16.       }
  17.     }
  18.   }
  19. }

http-proxy

配置 HTTP 代理以访问外部服务，包括下载镜像和备份到 S3 服务。

默认值：{}

你可以设置以下的选项和值：

  • HTTP 请求的代理 URL："httpProxy": "http://<username>:<pswd>@<ip>:<port>"
  • HTTPS 请求的代理 URL："httpsProxy": "https://<username>:<pswd>@<ip>:<port>"
  • 主机名和/或 CIDR 的逗号分隔列表："noProxy": "<hostname | CIDR>"

设置 - 图5警告

如果你配置了 httpProxy 和 httpsProxy，那么你必须同时将 Harvester 节点的 CIDR 填入 noProxy，否则 Harvester 集群将会崩溃。 如果你还配置了 cluster-registration-url，你通常需要将 cluster-registration-url 的主机也添加到 noProxy 中，否则你无法从 Rancher 访问 Harvester 集群。

示例

  1. {
  2.   "httpProxy": "http://my.proxy",
  3.   "httpsProxy": "https://my.proxy",
  4.   "noProxy": "some.internal.svc,172.16.0.0/16"
  5. }

设置 - 图6备注

Harvester 在用户配置的 no-proxy 后附加必要的地址，来确保内部流量能正常工作。 例如：localhost,127.0.0.1,0.0.0.0,10.0.0.0/8,longhorn-system,cattle-system,cattle-system.svc,harvester-system,.svc,.cluster.local。v1.1.2 开始将 harvester-system 添加到列表。

设置 - 图7警告

更改此设置可能会导致单节点集群产生较短的停机时间。

log-level

配置 Harvester Server 的日志级别。

默认值：info

你可以设置以下值。日志级别按照简单到详细排列：

  • panic
  • fatal
  • error
  • warn, warning
  • info
  • debug
  • trace

示例

  1. debug

overcommit-config

配置 CPU、内存和存储的资源超售百分比。设置资源超售后，即使物理资源已经用完，也能调度额外的虚拟机。

默认值：{ "cpu":1600, "memory":150, "storage":200 }

默认超售比 CPU 1600% 指的是，如果虚拟机的 CPU 资源限制是 1600m 核，Harvester 只会向 Kubernetes 调度器请求 100m CPU。

示例

  1. {
  2.   "cpu": 1000,
  3.   "memory": 200,
  4.   "storage": 300
  5. }

release-download-url

从 v1.0.1 起可用

此设置用于配置升级版本下载的 URL 地址。Harvester 将从该 URL 托管的 (${URL}/${VERSION}/version.yaml) 文件中获取 ISO URL 和校验和值。

默认值：https://releases.rancher.com/harvester

version.yaml 示例

  1. apiVersion: harvesterhci.io/v1beta1
  2. kind: Version
  3. metadata:
  4.   name: ${VERSION}
  5.   namespace: harvester-system
  6. spec:
  7.   isoChecksum: ${ISO_CHECKSUM}
  8.   isoURL: ${ISO_URL}

server-version

显示 Harvester Server 的版本。

示例

  1. v1.0.0-abcdef-head

ssl-certificates

为 Harvester UI/API 配置服务证书。

默认值：{}

示例

  1. {
  2.   "ca": "-----BEGIN CERTIFICATE-----\nSOME-CERTIFICATE-ENCODED-IN-PEM-FORMAT\n-----END CERTIFICATE-----",
  3.   "publicCertificate": "-----BEGIN CERTIFICATE-----\nSOME-CERTIFICATE-ENCODED-IN-PEM-FORMAT\n-----END CERTIFICATE-----",
  4.   "privateKey": "-----BEGIN RSA PRIVATE KEY-----\nSOME-PRIVATE-KEY-ENCODED-IN-PEM-FORMAT\n-----END RSA PRIVATE KEY-----"
  5. }

设置 - 图8警告

更改此设置可能会导致单节点集群产生较短的停机时间。

ssl-parameters

修改 Harvester GUI 和 API 启用的 SSL/TLS 协议和密码。

你可以设置以下的选项和值：

  • protocols：启用的协议。参见 NGINX Ingress Controller 的配置 ssl-protocols 来了解支持的输入。

  • ciphers：启用的密码。参见 NGINX Ingress Controller 的配置 ssl-ciphers 来了解支持的输入。

如果没有提供值，protocols 仅会设为 TLSv1.2，而 ciphers 列表会是 ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305。

默认值：none

设置 - 图9备注

如果你进行了错误配置，导致无法访问 Harvester GUI 和 API，请参见故障排查。

示例

以下示例将启用的 SSL/TLS 协议设置为 TLSv1.2 和 TLSv1.3，并把密码列表设置为 ECDHE-ECDSA-AES128-GCM-SHA256 和 ECDHE-ECDSA-CHACHA20-POLY1305：

  1. {
  2.   "protocols": "TLSv1.2 TLSv1.3",
  3.   "ciphers": "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305"
  4. }

storage-network

默认情况下，Longhorn 使用 Harvester 集群中的默认管理网络，该网络仅限于单个接口，并与集群内的其他工作负载共享。此设置允许你在想要进行网络隔离时配置隔离存储网络。

详情请参考 Harvester 存储网络。

设置 - 图10警告

如果要更改存储网络，你需要在应用此设置之前关闭所有虚拟机。 IP 范围格式是 IPv4 CIDR，而且是集群节点数的 4 倍。

默认值：””

示例

  1. {
  2.   "vlan": 100,
  3.   "clusterNetwork": "storage",
  4.   "range": "192.168.0.0/24"
  5. }

ui-index

为 UI 配置 HTML 索引位置。

默认值：https://releases.rancher.com/harvester-ui/dashboard/latest/index.html

示例

  1. https://your.static.dashboard-ui/index.html

ui-plugin-index

为 Harvester 插件配置 JS 地址 (从 Rancher 中访问 Harvester 时使用)。

默认值：https://releases.rancher.com/harvester-ui/plugin/harvester-latest/harvester-latest.umd.min.js

示例

  1. https://your.static.dashboard-ui/*.umd.min.js

ui-source

配置如何加载 UI 源。

你可以设置以下值：

  • auto：默认。自动检测是否使用绑定的 UI。
  • external：使用外部 UI 源。
  • bundled：使用绑定的 UI 源。

示例

  1. external

upgrade-checker-enabled

自动检查是否有可用的 Harvester 升级。

默认值：true

示例

  1. false

upgrade-checker-url

为 Harvester 升级检查配置 URL。只有 upgrade-checker-enabled 设为 true 时才可用。

默认值：https://harvester-upgrade-responder.rancher.io/v1/checkupgrade

示例

  1. https://your.upgrade.checker-url/v99/checkupgrade

vip-pools

使用 CIDR 或 IP 范围配置 VIP 的全局或命名空间 IP 地址池。

默认值：{}

设置 - 图11备注

从 UI 配置多 CIDR 或 IP 范围，只在 Harvester v1.1.1 中可用。

示例

  1. {
  2.   "default": "172.16.0.0/24,172.16.1.0/24",
  3.   "demo": "172.16.2.50-172.16.2.100,172.16.2.150-172.16.3.200"
  4. }

vm-force-reset-policy

当节点不可用时，强制重新调度虚拟机。当节点状态变成 Not Ready 时，此设置会强制删除该节点上的虚拟机，并在几秒后将虚拟机重新调度到另一个可用的节点。 Harvester 升级检查配置 URL。

默认值：{"enable":true, "period":300}

示例

  1. {
  2.   "enable": "true",
  3.   "period": 300
  4. }