调优实例

你可以用一个 values 文件来调优实例：副本数、CPU 和内存、某个区域自身的配置。通过 --values 把它交给 dcctl bootstrap 或 dcctl upgrade，dcctl 会把它记录在实例上，此后每次 dcctl upgrade 都会自动再次应用，无需你重复指定。没有这条记录，升级会根据实例的声明重新生成其设置，你的调优就会被还原。

tuning.yaml

functionalAreas:
  device-management:
    replicas: 3
    resources:
      limits:
        cpu: "3"
  event-sources:
    config:
      capture:
        publishWindow: 512

# 在 bootstrap 时
dcctl bootstrap local my-instance --values tuning.yaml

# 对运行中的实例
dcctl upgrade local my-instance --values tuning.yaml

# 之后每次升级都会继续应用，无需重复
dcctl upgrade local my-instance --version <new-version>

覆盖层如何与 dcctl 设置的值组合

共三层，后一层覆盖前一层：

1. chart 的默认值。
2. dcctl 根据实例声明计算出的值：镜像、凭据、端点、配置档和区域，以及 --compact 或 --ha 这类预设所隐含的规模设置。
3. 你的覆盖层。

映射按键逐项合并，因此你只需写出想更改的键。列表或单个值会替换其下的内容。重复使用 --values 可叠加多个文件，后面的文件优先。

覆盖层应用于 chart 渲染实例配置时所用的同一份值，因此像 shutdownDrainSeconds 这样的设置既会到达 Pod，也会进入配置文档。

可以设置什么

覆盖层只能设置下表中的值，其他一律被拒绝。

值	控制内容
replicas、rollingUpdate、terminationGracePeriodSeconds、nodeLossTolerationSeconds、shutdownDrainSeconds、podDisruptionBudget、startupProbe、livenessProbe	所有区域的规模与滚动更新
resources、useMeasuredRequests、goMemLimitPercent、gogc、goMemLimit	所有区域的 CPU、内存以及 Go 的内存行为
functionalAreas.<area>.replicas、.strategy、.resources、.measuredRequests、.goMemLimitPercent、.memoryLimitFloor、.gogc、.goMemLimit、.avoidEventStorePrimary、.eventPathSpread	同上，但只针对一个区域
functionalAreas.<area>.config	该区域自身的配置。未知的键会使服务在启动时停止
frontend.replicas、frontend.resources	控制台的 Pod
metrics.alerts、metrics.grafanaDashboards	告警规则和仪表板
ingress.className、ingress.annotations、ingress.uploadMaxBodySize、networkPolicy.additionalAllowedCidrs、serviceAccount.annotations	入口如何对外提供，以及谁可以访问 Pod

functionalAreas.event-management.replicas 虽然属于可调优区域，但它本身不可调：它由 --ha 设置，事件存储的连接预留量正是按它来确定的。

可调优子树中的某些值同样会被拒绝，因为它们是安全开关或连接配置，而不是容量参数：

• 在区域的 config 中：deviceAuthMode（device-management）、auth 块（user-management）、resourceUrl 和 issuerUrl（mcp）、updates.allowUnverifiedArtifacts 和 updates.downloadBaseURL（update-management）、eventSources（event-sources）、sources（sparkplug-ingest）、任何区域的 tsdbConfiguration，以及 rdbConfiguration.sqlDebug。键的匹配不区分大小写，与服务读取它们的方式一致。
• 在 ingress.annotations 中：chart 已在其入口上设置的每一个注解（你的值会替换 chart 的值）、任何 *-snippet 注解、cert-manager.io/*，以及 ssl-redirect 或 force-ssl-redirect。

serviceAccount.annotations 是允许的，因为 s3 对象存储的云身份（workload identity，或服务账号的 IAM 角色）正是在这里绑定的。实例的所有服务 Pod 共用这个服务账号，因此在这里绑定的角色它们全都持有：授予的权限不要超过存储桶所需。

dcctl 拥有的一切都会被拒绝：镜像与版本、凭据和密钥库根密钥、代理与数据库端点、入口主机和 TLS、配置档和区域集合（由 dcctl enable-area 更改）、对象存储设置、安全上下文，以及 dcctl 自行在版本之间延续的 LwM2M 和 MQTT 消息体凭据设置。这里刻意采用允许列表：chart 在后续版本中新增的值，在被加入此列表之前一直会被拒绝，而不会意外变成可设置。

拒绝信息会在任何更改发生之前，列出每一个违规的键及其所在文件：

--values tuning.yaml sets values dcctl does not let an overlay set, so nothing has been changed:
  image.tag: this is not an operator-tunable value: dcctl or the chart owns it (images, credentials, endpoints, exposure, the area set, security contexts)

在应用任何内容之前，覆盖层还会对照 chart 的 values 模式进行校验，并与实例的其他值一起渲染。类型错误的值、超过上限的请求量，或 chart 拒绝的组合，都会使本次运行在未做任何更改的情况下停止。

副本数与数据库的连接预算

每个实例的数据库登录账号被限制为其服务能够打开的连接数：每个 Pod 一个完整的连接池，并为滚动更新预留一倍。覆盖层如果提高了使用关系型数据库的区域的副本数，或该区域的连接池（functionalAreas.<area>.config.rdbConfiguration.maxOpenConnections），这个上限也会随之提高，dcctl 会在做任何更改之前向共享数据库申请更大的上限。如果集群的连接预算无法满足，本次运行会在未做任何更改的情况下停止：降低覆盖层中的值，或用 dcctl install --max-connections 提高预算。移除覆盖层会归还这些连接。

更改或移除覆盖层

dcctl upgrade 上的 --values 会整体替换已记录的覆盖层，而不是与之合并。要增加一个键，请把它与已有的键一起写进文件。要移除覆盖层、让实例回到 dcctl 计算的值：

dcctl upgrade local my-instance --reset-values

--values 与 --reset-values 不能同时使用。dcctl enable-area，以及两个标志都没有给出的升级，会原样保留已记录的覆盖层。

先看会有什么变化

--dry-run 会打印已记录的覆盖层与本次运行结束后的覆盖层之间的差异：

  Overlay: changes to the recorded tuning:
    ~ functionalAreas.device-management.replicas: 3 -> 4
    + gogc: 400
    - functionalAreas.device-state.replicas: 2
[dry-run] would record the values overlay in the instance declaration

+ 表示新增，- 表示移除，~ 表示更改。

覆盖层保存在哪里

覆盖层保存在集群内实例的声明上，注解名为 core.devicechain.io/values-overlay。任何能访问该集群的机器升级时都会用到它；不会在执行 bootstrap 的那台机器上留下文件。销毁实例会一并将其移除。

任何能读取实例声明的人都能读取覆盖层。它不能设置凭据，但区域的 config 是自由格式，因此请不要在其中放入机密。

升级拒绝已记录的覆盖层时

新版本可能重命名某个值，或收紧其可接受的范围。升级会在更改任何内容之前，对照目标版本检查已记录的覆盖层，不再适用时会点名相关的键并停止。可用 --values <修正后的文件> 修正，或用 --reset-values 移除。

应用它会发生什么

覆盖层与其他所有设置经由同一个发布版本应用，因此改变 Pod 设置或某区域 config 的更改会滚动该区域的 Pod；运行中的 Pod 不会重新读取它。会在服务之间转移负载的调优，例如事件路径上的副本数，建议先用 --dry-run 演练，并在实例空闲时再推出。