|
本文档采用自动化机器翻译技术翻译。 尽管我们力求提供准确的译文,但不对翻译内容的完整性、准确性或可靠性作出任何保证。 若出现任何内容不一致情况,请以原始 英文 版本为准,且原始英文版本为权威文本。 |
设置
以下是您可以使用的高级设置列表。您可以使用 UI 和 kubectl 命令修改 settings.harvesterhci.io 自定义资源。
一般设置
additional-ca
定义:额外的受信任 CA 证书,使 SUSE Virtualization 能够访问外部服务。
|
更改此设置可能会导致单节点集群暂时不可用或无法访问。 |
默认值:无
示例:
-----BEGIN CERTIFICATE----- SOME-CA-CERTIFICATES -----END CERTIFICATE-----
auto-disk-provision-paths [实验性]
定义:允许 SUSE Virtualization 自动添加与指定的 glob 模式匹配的磁盘作为 VM 存储的设置。
此设置仅添加已挂载到系统的格式化磁盘。在指定多个模式时,使用逗号分隔值。
|
此设置适用于集群中的 所有节点。存储设备中的所有数据 将被销毁。 |
默认值:无
示例:
以下示例添加与 glob 模式 /dev/sd* 或 /dev/hd* 匹配的磁盘:
/dev/sd*,/dev/hd*
auto-rotate-rke2-certs
定义:允许您自动轮换 SUSE® Rancher Prime: RKE2 服务证书的设置。在默认情况下会禁用该设置。
使用字段 expiringInHours 指定每个证书的有效期(1 到 8759 小时)。如果证书在指定期限内过期,SUSE Virtualization 将自动替换证书。
有关更多信息,请参见 证书轮换 部分的 SUSE Rancher Prime 和 SUSE® Rancher Prime: RKE2 文档。
如果您的证书已过期,您可以 手动轮换它们。
默认值:{"enable":false,"expiringInHours":240}
示例:
{"enable":true,"expiringInHours":48}
backup-target
定义:用于存储 VM 备份的自定义备份目标。
有关详细信息,请参见 SUSE Storage 文档。
默认值:无
示例:
{
"type": "s3",
"endpoint": "https://s3.endpoint.svc",
"accessKeyId": "test-access-key-id",
"secretAccessKey": "test-access-key",
"bucketName": "test-bup",
"bucketRegion": "us‑east‑2",
"cert": "",
"virtualHostedStyle": false
}
cluster-registration-url
定义:用于将 SUSE Virtualization 集群导入 SUSE Rancher Prime 以进行多集群管理的 URL。
当您配置此设置时,将在名称空间 cattle-system 中创建一个名为 cattle-cluster-agent-* 的新 pod 以进行注册。此 pod 使用的容器镜像是 rancher/rancher-agent:related-version,该镜像未打包到 SUSE Virtualization .iso 映像中,而是由 SUSE Rancher Prime 确定。related-version 通常与 SUSE Rancher Prime 版本相同。例如,当您将 SUSE Virtualization 注册到 SUSE Rancher Prime v2.7.9 时,镜像为 rancher/rancher-agent:v2.7.9。有关详细信息,请参见 查找您 Rancher 版本所需的资产。
根据您的设置,镜像将从以下位置之一下载:
-
SUSE Virtualization containerd-registry:您可以为集群配置一个 私有注册表。
-
Docker Hub (docker.io):当您未在 SUSE Rancher Prime 中配置私有注册表时,这是默认选项。
或者,您可以获取镜像的副本并手动将其上传到所有节点。
默认值:无
示例:
https://172.16.0.1/v3/import/w6tp7dgwjj549l88pr7xmxb4x6m54v5kcplvhbp9vv2wzqrrjhrc7c_c-m-zxbbbck9.yaml
containerd-registry
定义:为 SUSE Virtualization 集群创建的私有注册表的配置。
该值存储在每个节点的 registries.yaml 文件中(路径:/etc/rancher/rke2/registries.yaml)。有关详细信息,请参见 Containerd 注册表配置 中的 SUSE® Rancher Prime: RKE2 文档。
出于安全考虑,SUSE Virtualization 会在将用户名和密码存储在 registries.yaml 文件后自动删除为私有注册表配置的凭据。
示例:
{
"Mirrors": {
"docker.io": {
"Endpoints": ["https://myregistry.local:5000"],
"Rewrites": null
}
},
"Configs": {
"myregistry.local:5000": {
"Auth": {
"Username": "testuser",
"Password": "testpassword"
},
"TLS": {
"InsecureSkipVerify": false
}
}
}
}
csi-driver-config
定义:使用安装在集群中的第三方 CSI 驱动程序所需的配置。
在使用与备份和快照相关的功能之前,您必须配置以下信息:
-
已安装的第三方 CSI 驱动程序的供应商
-
volumeSnapshotClassName:用于创建卷快照或虚拟机快照的VolumeSnapshotClass的名称。 -
backupVolumeSnapshotClassName:用于创建虚拟机备份的VolumeSnapshotClass的名称。
默认值:
{
"driver.longhorn.io": {
"volumeSnapshotClassName": "longhorn-snapshot",
"backupVolumeSnapshotClassName": "longhorn"
}
}
csi-online-expand-validation
定义:允许您将确认支持在线卷扩展的存储提供商标记为已验证的设置。
根据底层存储提供商,您可能需要采取额外步骤来使用在线卷扩展功能。
-
SUSE Storage: SUSE Virtualization 认为 SUSE Storage 支持在线卷扩展,即使 Longhorn 数据引擎的版本之间存在差异。目前,V1 数据引擎完全支持在线卷扩展,而 V2 数据引擎根本不支持卷扩展(无论卷的附加状态如何)。SUSE Virtualization 网络钩子管理这些版本之间的差异。
-
第三方存储: SUSE Virtualization 默认拒绝第三方存储的在线卷扩展请求。如果您已确认您的存储提供商支持在线卷扩展,您可以使用此设置将该存储提供商标记为已验证,并强制 SUSE Virtualization 允许相关的在线扩展请求。
默认值:{"driver.longhorn.io":true}
default-vm-termination-grace-period-seconds
定义:SUSE Virtualization 在使用 UI 停止虚拟机后,强制关闭虚拟机之前等待的秒数。
SUSE Virtualization 向任何使用 UI 停止的虚拟机发送优雅关闭信号。如果在指定的秒数内未完成优雅关闭过程,SUSE Virtualization 将强制关闭虚拟机。
默认值:120
http-proxy
定义:用于访问外部服务的 HTTP 代理,包括下载镜像和备份到 S3 服务。
|
更改此设置可能会导致单节点集群暂时不可用或无法访问。 |
默认值:{}
支持的选项和值:
-
HTTP 请求的代理 URL:
"httpProxy": "http://<username>:<pswd>@<ip>:<port>" -
HTTPS 请求的代理 URL:
"httpsProxy": "https://<username>:<pswd>@<ip>:<port>" -
以逗号分隔的主机名和/或 CIDR 列表:
"noProxy": "<hostname | CIDR>"
如果您配置了以下选项或设置,必须在 noProxy 字段中指定关键信息:
| 已配置的选项/设置 | 在`noProxy`中所需的值 | 原因 |
|---|---|---|
|
节点的CIDR |
不指定节点的CIDR可能会导致集群故障。 |
|
`cluster-registration-url`的主机 |
主机信息允许您从SUSE Rancher Prime访问集群。 |
SUSE Virtualization将必要的地址附加到用户指定的`noProxy`值(例如,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)。这确保内部流量按预期流动。
示例:
{
"httpProxy": "http://my.proxy",
"httpsProxy": "https://my.proxy",
"noProxy": "some.internal.svc,172.16.0.0/16"
}
log-level
定义:主机的日志级别。
默认值:info
支持的选项和值:
-
panic:最少冗长的日志级别 -
fatal -
error -
warn、warning -
info -
debug -
trace:最冗长的日志级别
示例:
debug
longhorn-v2-data-engine-enabled [实验性]
定义:启用和禁用Longhorn V2数据引擎的设置。
当设置为`true`时,SUSE Virtualization会自动加载Longhorn V2数据引擎所需的内核模块,并尝试在所有节点上分配1024 × 2 MiB大小的大页(例如,2 GiB RAM)。
更改此设置会自动在所有节点上重启SUSE® Rancher Prime: RKE2,但不会影响正在运行的虚拟机工作负载。
|
如果您遇到包含短语"没有足够的hugepages-2Mi容量"的错误消息,请等待一段时间以解决该错误。如果错误仍然存在,请重启受影响的节点。 要在特定节点(例如,处理器和内存资源较少的节点)上禁用Longhorn V2数据引擎,请转到*主机*屏幕,并将以下标签添加到目标节点:
|
默认值:false
示例:
true
max-hotplug-ratio
定义:确定正在运行的虚拟机可用的默认最大处理器和内存资源量的设置。该比例乘以您在创建虚拟机时分配的CPU和内存资源量。
默认值:4
支持的值:1 到 20
示例:
max-hotplug-ratio 被设置为 4。
| 资源 | 分配的数量 | 最大可用数量 |
|---|---|---|
处理器核心数 |
|
|
内存(Gi) |
|
|
ntp-servers
定义:用于节点时间同步的NTP服务器。
您可以在 安装 期间定义 NTP 服务器,并在安装后更新地址。
|
对服务器地址列表的更改将应用于所有节点。 |
默认值:""
示例:
{
"ntpServers": [
"0.suse.pool.ntp.org",
"1.suse.pool.ntp.org"
]
}
overcommit-config
定义:可以分配给虚拟机使用的物理计算、内存和存储资源的百分比。
超额分配用于优化物理资源分配,特别是在虚拟机大部分时间不预期完全消耗分配的资源时。设置大于 100% 的值允许调度多个虚拟机,即使物理资源在名义上完全分配。
默认值:{ "cpu":1600, "memory":150, "storage":200 }
使用默认值,可以调度以下内容:
-
主机上物理 CPU 数量的 16 倍
-
主机上物理 RAM 数量的 1.5 倍
-
在 SUSE Storage 中物理存储量的 2 倍
配置为使用 2 个 CPU(相当于 2000 毫CPU)的虚拟机可以在资源可用的情况下消耗全部分配。然而,如果主机正在运行重负载并且设置了超分配值(例如,1600%),SUSE Virtualization 仅从 Kubernetes 调度器请求 125 毫CPU(2000/16 = 125 毫CPU)。
示例:
{
"cpu": 1000,
"memory": 200,
"storage": 300
}
release-download-url
定义:用于下载所需软件以进行升级的 URL。
SUSE Virtualization 从可通过配置的 URL 访问的 ${URL}/${VERSION}/version.yaml 文件中检索 ISO URL 和校验和。
示例 (version.yaml):
apiVersion: harvesterhci.io/v1beta1
kind: Version
metadata:
name: ${VERSION}
namespace: harvester-system
spec:
isoChecksum: ${ISO_CHECKSUM}
isoURL: ${ISO_URL}
ssl-certificates
定义:用于 UI 和 API 的 SSL 证书。
|
更改此设置可能会导致单节点集群暂时不可用或无法访问。 |
默认值:{}
示例:
{
"ca": "-----BEGIN CERTIFICATE-----\nSOME-CERTIFICATE-ENCODED-IN-PEM-FORMAT\n-----END CERTIFICATE-----",
"publicCertificate": "-----BEGIN CERTIFICATE-----\nSOME-CERTIFICATE-ENCODED-IN-PEM-FORMAT\n-----END CERTIFICATE-----",
"privateKey": "-----BEGIN RSA PRIVATE KEY-----\nSOME-PRIVATE-KEY-ENCODED-IN-PEM-FORMAT\n-----END RSA PRIVATE KEY-----"
}
ssl-parameters
定义:UI 和 API 的启用的 SSL/TLS 协议和密码。
|
重要的
如果您错误配置此设置并无法访问 UI 和 API,请参见 故障排除。 |
默认值:无
支持的选项和值:
-
protocols:启用的协议。 -
ciphers:启用的密码。
有关支持的选项的更多信息,请参见 ssl-protocols 和 ssl-ciphers 在 Ingress-Nginx 控制器文档中。
如果您未指定任何值,SUSE Virtualization 将使用 TLSv1.2 和 ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305。
示例:
{
"protocols": "TLSv1.2 TLSv1.3",
"ciphers": "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305"
}
storage-network
定义:用于 SUSE Storage 流量的隔离存储网络。
默认情况下,SUSE Storage 使用管理网络,该网络仅限于单个接口,并与集群范围的工作负载共享。如果您的实现需要网络隔离,您可以使用 存储网络 来隔离 SUSE Storage 集群内数据流量。
|
重要的
在配置此设置之前,请关闭所有虚拟机。 以 IPv4 CIDR 格式指定 IP 范围。IP 的数量必须是集群节点数量的四倍。 |
默认值:""
示例:
{
"vlan": 100,
"clusterNetwork": "storage",
"range": "192.168.0.0/24"
}
support-bundle-image
定义:支持包镜像, rancher/support-bundle-kit 中提供各种版本。
默认值:support-bundle-kit 镜像被打包到 SUSE Virtualization .iso 映像中,并且特定于每个 SUSE Virtualization 版本。
支持的选项和值:
该值是一个 JSON 对象字面量,包含以下键值对:
-
repository:存储支持包镜像的储存库名称。 -
tag: 分配给支持包镜像的标签。 -
imagePullPolicy:支持包图像的拉取策略。受支持的值为IfNotPresent、Always和Never。有关更多信息,请参见 Kubernetes 文档中的 图像拉取策略。
示例:
{
"repository": "rancher/support-bundle-kit",
"tag": "v0.0.25",
"imagePullPolicy": "IfNotPresent"
}
在此示例中,集群的默认图像标签为 v0.0.25。
CLI 显示以下 support-bundle-image 设置对象:
apiVersion: harvesterhci.io/v1beta1
default: '{"repository":"rancher/support-bundle-kit","tag":"v0.0.25","imagePullPolicy":"IfNotPresent"}' // default value, automatically set
kind: Setting
metadata:
name: support-bundle-image
...
status: {}
过了一段时间,使用 UI 在 value 字段中指定了一个较新的图像标签 (v0.0.36)。
apiVersion: harvesterhci.io/v1beta1
default: '{"repository":"rancher/support-bundle-kit","tag":"v0.0.25","imagePullPolicy":"IfNotPresent"}'
kind: Setting
metadata:
name: support-bundle-image
...
status: {}
value: '{"repository":"rancher/support-bundle-kit","tag":"v0.0.36","imagePullPolicy":"IfNotPresent"}' // your setting value
最终,该集群被升级,对象再次发生变化。
apiVersion: harvesterhci.io/v1beta1
default: '{"repository":"rancher/support-bundle-kit","tag":"v0.0.38","imagePullPolicy":"IfNotPresent"}' // default value, automatically updated after upgrade
kind: Setting
metadata:
name: support-bundle-image
...
status: {}
value: '{"repository":"rancher/support-bundle-kit","tag":"v0.0.36","imagePullPolicy":"IfNotPresent"}' // your setting value is kept unchanged
在 value 字段中,tag 的值为 v0.0.36,而在 default 字段中,tag 的值为 v0.0.38。
要清除过时的设置并使用默认图像标签,请运行以下命令,删除 value 字段,并保存更改。
$ kubectl edit settings.harvesterhci.io support-bundle-image
在删除 value 字段后,对象如下所示。
apiVersion: harvesterhci.io/v1beta1
default: '{"repository":"rancher/support-bundle-kit","tag":"v0.0.38","imagePullPolicy":"IfNotPresent"}'
kind: Setting
metadata:
name: support-bundle-image
...
status: {}
UI 上的 使用默认值 按钮可用于将 default 字段的内容复制到 value 字段。
在保存更改后,对象如下所示。
apiVersion: harvesterhci.io/v1beta1
default: '{"repository":"rancher/support-bundle-kit","tag":"v0.0.38","imagePullPolicy":"IfNotPresent"}' // default
kind: Setting
metadata:
name: support-bundle-image
...
status: {}
value: '{"repository":"rancher/support-bundle-kit","tag":"v0.0.38","imagePullPolicy":"IfNotPresent"}' // copied from default
当集群在未来升级时,value 字段的内容可能会再次过时,因为默认图像标签可能会发生变化。
|
support-bundle-namespaces
定义:您在 生成支持包 时可以使用的其他名称空间。
默认情况下,支持包仅收集以下预定义命名空间中的资源:
-
cattle-dashboards
-
cattle-fleet-local-system
-
cattle-fleet-system
-
cattle-fleet-clusters-system
-
cattle-monitoring-system
-
fleet-local
-
harvester-system
-
本地
-
longhorn-system
-
cattle-logging-system
您选择的名称空间将附加到预定义名称空间列表中。
默认值:无
support-bundle-timeout
定义:SUSE Virtualization 允许完成支持包生成过程的分钟数。
当数据收集和文件打包任务未在配置的分钟数内完成时,过程被视为失败。SUSE Virtualization 不会继续或重试超时的支持包生成过程。当值为 0 时,超时功能被禁用。
默认值:10
support-bundle-expiration
定义:SUSE Virtualization 等待的分钟数,在此期间删除已打包但未下载(无论是故意还是未成功)或保留的支持包。
您可以指定大于或等于 0 的值。当值为 0 时,SUSE Virtualization 使用默认值。
默认值:30
support-bundle-node-collection-timeout
定义:SUSE Virtualization 允许在节点上收集日志和配置以生成支持包的分钟数。
如果收集过程未在规定时间内完成,SUSE Virtualization 仍然允许您下载支持包(不包含未收集的数据)。您可以指定大于或等于 0 的值。当值为 0 时,SUSE Virtualization 使用默认值。
默认值:30
upgrade-checker-url
定义:用于检查可用升级的 URL。
此设置仅在 upgrade-checker-enabled 设置为 true 时可用。
示例:
https://your.upgrade.checker-url/v99/checkupgrade
upgrade-config
定义:与升级相关的配置。
默认值:
{
"imagePreloadOption": {
"strategy": {
"type": "sequential"
}
},
"nodeUpgradeOption": {
"strategy": {
"mode": "auto"
}
},
"restoreVM": false,
"logReadyTimeout": "5"
}
支持的选项和字段:
-
imagePreloadOption:图像预加载阶段的选项。完整的 ISO 包含核心操作系统组件和所有所需的容器镜像。SUSE Virtualization 可以在安装和升级期间将这些容器镜像预加载到每个节点。当工作负载被调度到管理节点和工作节点时,容器镜像已准备好使用。
-
strategy:图像预加载策略。-
type:图像预加载策略的类型。-
sequential:来自目标 ISO 的容器镜像被预加载到每个节点。这是默认选项。 -
skip:容器镜像未被预加载到每个节点。在生产环境中请勿使用此选项。如果您决定使用
skip,请确保满足以下要求:-
您有一个包含所有所需镜像的私有容器注册表。
-
您的集群具有高速互联网访问,并能够在必要时从 Docker Hub 拉取所有镜像。
注意任何潜在的互联网服务中断,以及您距离达到 Docker Hub 速率限制 的距离。未能下载任何所需镜像可能导致升级失败,并可能使集群处于中间状态。
-
-
parallel(实验性):节点批量预加载图像。您可以使用concurrency选项进行调整。
-
-
concurrency:可以同时预加载图像的节点数量。此选项仅在`type`设置为`parallel`时生效。默认值为`0`,相当于遵循集群的节点数量。使用`0`可以让系统动态跟随集群的规模。高于集群节点数量的值被视为`0`,而低于该值的则被视为无效并被拒绝。
SUSE Virtualization在集群上部署一个升级仓库服务,作为需要预加载容器图像的节点的HTTP服务器。当设置`concurrency`值时,每批节点会并行从此升级仓库下载容器图像。因此,您必须考虑SUSE Virtualization管理网络的速度以及SUSE Storage默认磁盘的读取速度。
-
-
-
nodeUpgradeOption:定义SUSE Virtualization如何执行节点升级。节点升级是一个原子操作,包括升级节点的RKE2组件和操作系统。升级要么完全完成,要么失败,没有半完成的状态。
为了准备目标节点进行升级,SUSE Virtualization首先尝试将所有正在运行的虚拟机实时迁移到其他节点。无法实时迁移的虚拟机会被自动关闭,以避免在后续升级步骤中出现潜在的中断和问题。
-
strategy:节点升级策略。-
mode:节点升级策略的模式。-
auto:节点升级自动开始。此值是默认值。 -
manual:节点升级被暂停,直到您采取特定措施以恢复该过程。
-
-
pauseNodes:必须排除在自动升级之外的节点列表。如果
mode字段设置为manual,并且您未在此字段中指定任何节点名称,则所有节点的升级将被暂停。如果mode字段设置为auto,则此字段中指定的节点名称将被忽略,节点升级将自动开始。在此字段中列出的节点的升级将 暂停,直到您采取具体措施 恢复该过程。鉴于 SUSE Virtualization 按顺序升级节点,这意味着整个升级进度也被暂停。
示例:
"pauseNodes": ["node-0", "node-2"]
-
-
-
restoreVM:启用此选项后,SUSE Virtualization 会在升级 成功 完成后,自动恢复之前运行的 不可迁移虚拟机。您可以指定以下任一值:-
true:SUSE Virtualization 强制关闭每个节点上 正在运行 和 暂停 的不可迁移虚拟机。升级完成后,之前运行的虚拟机将自动重启,而暂停的虚拟机将保持关闭状态。 -
false:此值是默认值。在多节点环境中,您必须停止所有不可迁移虚拟机,以允许升级进行。SUSE Virtualization 在升级完成后不会重启这些虚拟机。在单节点环境中,所有虚拟机都被视为不可迁移的。SUSE Virtualization 在开始升级过程之前强制关闭所有虚拟机。
-
-
logReadyTimeout:SUSE Virtualization 允许创建升级日志基础设施的分钟数。-
默认值:
"5" -
有效值:
"","1"到"20"(用双引号括起来)
-
示例:
{
"imagePreloadOption": {
"strategy": {
"type": "parallel",
"concurrency": 2
}
},
"nodeUpgradeOption": {
"strategy": {
"mode": "manual",
"pauseNodes": [
"node-3"
]
}
}
"restoreVM": true,
"logReadyTimeout": "5"
}
vip-pools
版本:自 v1.2.0 起已弃用(请改用 IP 池)。
定义:通过 CIDR 或 IP 范围的 VIP 的全局或命名空间特定 IP 地址池。
默认值:{}
示例:
{
"default": "172.16.0.0/24,172.16.1.0/24",
"demo": "172.16.2.50-172.16.2.100,172.16.2.150-172.16.3.200"
}
vm-force-reset-policy
定义:允许您在运行的节点变得不可用时强制重新调度虚拟机的设置。
当节点状态变为 Not Ready 时,虚拟机将被强制删除,并在配置的秒数后重新调度到可用节点。
当节点变得不可用或关闭时,虚拟机仅重启而不迁移。
支持的选项:
-
period:SUSE Virtualization 表示在为失败节点添加kubevirt.io/drain污点之前等待的秒数。此选项触发虚拟机的迁移。 -
vmMigrationTimeout:SUSE Virtualization 表示在为失败节点添加node.kubernetes.io/out-of-service污点之前等待的秒数。此选项强制清理孤立资源。
默认值:{"enable":true, "period":15, "vmMigrationTimeout": 180}
示例:
{
"enable": "true",
"period": 15,
"vmMigrationTimeout": 180
}
vm-migration-network
定义:用于虚拟机迁移流量的隔离网络。
默认情况下,SUSE Virtualization 使用内置集群网络 mgmt 进行虚拟机迁移。mgmt 限制为单个接口,并与集群范围的工作负载共享。如果您的实现需要网络隔离,您可以使用 虚拟机迁移网络 来隔离迁移流量。
|
以 IPv4 CIDR 格式指定 IP 范围。IP 地址的数量必须大于或等于您的集群节点数量。 |
默认值:""
示例:
{
"vlan": 100,
"clusterNetwork": "vm-migration",
"range": "192.168.1.0/24"
}
用户界面设置
branding
定义:该设置允许您通过自定义产品名称、徽标和配色方案,对用户界面进行全局品牌重塑。
默认值:Harvester
|
因为此设置是 |
支持的选项和值:
-
私有标签:产品名称或其他文本,用于替换用户界面中大多数位置的 "Harvester"。
-
徽标:顶级导航头中的徽标图像。您必须为明亮和黑暗模式上传徽标。
-
网站图标:在浏览器标签中显示在页面标题旁的小图像。
-
主色:在整个用户界面中使用的主要颜色。
-
链接颜色:在整个用户界面中用于链接文本的颜色。
ui-path
定义:描述 index.html 位置的路径,用于访问用户界面。
ui-path 作为用户界面的入口点,仅在以下情况下有效:
-
ui-source的值为bundled。 -
ui-source的值为auto,但ui-index无法检索 HTML 文件。
默认值:/usr/share/harvester/harvester
示例:
index.html 存储在容器 /home/samplefolder 中。ui-source 的值为 bundled。
方案 1:`ui-path` 的值为 /home/samplefolder。每当您访问用户界面时,/home/samplefolder/index.html 的内容会显示。
方案 2:`ui-index` 的值指向一个不可用或不存在的页面(例如,notexist-example.com/index.html)。当您第一次访问用户界面时,/home/samplefolder/index.html 的内容会显示。但是,如果您将 ui-index 设置修改为使用默认值并再次访问用户界面,/home/samplefolder/index.html 的内容仍然会显示(即使新的 ui-index 值指向一个可用页面)。有关更多信息,请参见 问题 #6066。