Helm：如何覆盖名称中包含点号的配置值

我明白你现在卡在Helm配置Jenkins时，带点号的配置键无法正确设置的问题——这其实是YAML解析的坑，因为YAML会默认把点号当作嵌套层级的分隔符，而不是键名的一部分。结合你给出的values片段，我给你几个可行的解决方案：

1. 在values.yaml中用引号包裹带点的键名 #

如果你是在values.yaml里定义这类配置，直接给带点的键名加上双引号，就能强制YAML把它识别为单个完整的键，不会拆分里面的点号：

比如你现有的配置基础上，要添加带点的系统属性或脚本审批规则，可以这么写：

rbac:
  install: true
Master:
  HostName: jenkins.mycompany.com
  ServiceType: ClusterIP
  ImageTag: lts
  InstallPlugins:
    - kubernetes
    - workflow-aggregator
    - workflow-job
    - credentials-binding
    - git
    - blueocean
    - github
    - github-oauth
  ScriptApproval:
    # 带点的方法签名直接用引号包裹
    - "method groovy.json.JsonSlurperClassic parseText java.lang.String"
  # 示例：添加带点的Jenkins系统属性配置
  JCasC:
    configScripts:
      custom-system-props: |
        jenkins:
          systemProperties:
            "jenkins.model.Jenkins.slaveAgentPort": 50000
            "hudson.model.DirectoryBrowserSupport.CSP": "default-src 'self'"

2. 通过Helm命令行传递参数时转义点号 #

如果是在脚本里用helm install或helm upgrade的--set参数传递带点的键，需要用反斜杠转义点号，或者用单引号包裹整个配置块避免转义：

# 用双引号时转义内部的引号
helm upgrade --install jenkins jenkins/jenkins \
  --values your-values.yaml \
  --set Master.JCasC.configScripts.custom-system-props="jenkins: { systemProperties: { \"jenkins.model.Jenkins.slaveAgentPort\": 50000 } }"

# 用单引号更简洁，无需内部转义
helm upgrade --install jenkins jenkins/jenkins \
  --values your-values.yaml \
  --set Master.JCasC.configScripts.custom-system-props='jenkins: { systemProperties: { "jenkins.model.Jenkins.slaveAgentPort": 50000 } }'

3. 程序化生成values时的注意事项 #

如果是用Python、Shell等脚本动态生成values.yaml，要确保带点的键被正确包裹引号：
比如用Python的PyYAML库时，可以单独给带点的配置块添加引号，或者指定输出风格强制字符串键带引号：

import yaml

config = {
    "Master": {
        "JCasC": {
            "configScripts": {
                "custom-system-props": """jenkins:
  systemProperties:
    "jenkins.model.Jenkins.slaveAgentPort": 50000
"""
            }
        }
    }
}

with open("generated-values.yaml", "w") as f:
    yaml.safe_dump(config, f, default_flow_style=False)

本质上这个问题不是Helm或Jenkins的专属问题，是YAML的解析规则导致的——只要让YAML把带点的字符串识别为单个键而非嵌套层级，就能解决这个问题。

内容的提问来源于stack exchange，提问作者pnovotnak