如何通过Helm Chart参数化Nginx server-snippet中的跳转域名？

问题场景 #

在Helm Chart的values.yaml中硬编码域名配置Ingress的server-snippet注解时，URL跳转功能正常运行，但尝试通过helm template的--set参数动态传入域名时，触发如下语法错误：

Error: expected at most two arguments, unexpected arguments: =, /, {, rewrite, ^, https://example.com/auth, permanent;, break;, }*

报错原因 #

server-snippet内容包含大量特殊字符（空格、{}、^、;等），直接通过--set传递时，会被Shell或Helm的命令行解析器拆分成多个参数，导致语法解析失败。

解决方案 #

方案1：命令行直接传递（正确转义+引号包裹） #

通过转义注解的key（因为包含.），并用单引号包裹整个server-snippet内容，同时将域名作为独立的Values变量传入：

helm template my-release ./my-chart \
  --set ingress.annotations."nginx\.ingress\.kubernetes\.io/server-snippet"='location /auth { rewrite ^ https://${DOMAIN}/auth permanent; break; }' \
  --set DOMAIN=your-custom-domain.com

注意：

• 注解key中的.需要转义为\.，避免Helm将其解析为嵌套的Values路径
• 用单引号包裹snippet内容，防止Shell解析其中的特殊字符
• 域名通过独立的--set DOMAIN=xxx传入，在snippet中用${DOMAIN}引用

方案2：通过values文件传递（更易维护） #

在主values.yaml中预先定义带变量的snippet模板，再通过--set覆盖域名变量：

1. 修改values.yaml：

ingress:
  annotations:
    nginx.ingress.kubernetes.io/server-snippet: |
      location /auth {
        rewrite ^ https://{{ .Values.DOMAIN }}/auth permanent;
        break;
      }
# 默认域名，可通过--set覆盖
DOMAIN: example.com

2. 执行helm template时传入自定义域名：

helm template my-release ./my-chart --set DOMAIN=your-custom-domain.com

如果不想修改主values.yaml，也可以创建临时的覆盖文件values-override.yaml：

ingress:
  annotations:
    nginx.ingress.kubernetes.io/server-snippet: |
      location /auth {
        rewrite ^ https://{{ .Values.DOMAIN }}/auth permanent;
        break;
      }
DOMAIN: your-custom-domain.com

然后执行：

helm template my-release ./my-chart -f values-override.yaml

方案3：使用--set-string强制解析为字符串 #

如果不需要在snippet中引用Helm变量，只是直接传递完整的硬编码内容，可以用--set-string强制Helm将内容当作纯字符串解析：

helm template my-release ./my-chart \
  --set-string ingress.annotations."nginx\.ingress\.kubernetes\.io/server-snippet"='location /auth { rewrite ^ https://your-custom-domain.com/auth permanent; break; }'

总结 #

最推荐的是方案2，通过Values变量分离域名和snippet模板，既避免命令行的特殊字符解析问题，也让配置更易维护；如果必须用命令行传递，方案1的转义+引号包裹是可行的选择。

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