Kubernetes-Helm修改应用Host值及部署多环境实例问题

原因分析 #

cm-acme-http-solver-xxxx 是Cert Manager用于HTTP01域名验证的临时Pod，说明你的集群部署了Cert Manager，且应用的Ingress配置了自动签发TLS证书。修改Host后，Cert Manager会尝试为新域名签发证书，若验证失败（比如域名未解析、防火墙拦截），会导致证书无法就绪，进而Ingress资源无法更新，最终Host修改不生效。

解决步骤 #

1. 确认Helm参数传递正确
   确保你在执行helm upgrade时正确传递了修改后的Host值，优先用--set参数直接覆盖（避免本地values.yaml未同步的问题）：

   helm upgrade <你的Release名称> <Chart名称> --set ingress.hosts[0].host=xxx.prod.xxx.com
   

   如果你使用自定义values文件，需确保文件中Host字段已修改，再执行：

   helm upgrade <你的Release名称> <Chart名称> -f updated-values.yaml
   

   注意：替换<你的Release名称>和<Chart名称>为实际值，同时确认Chart中Host对应的values路径（比如可能是service.host，需根据你的Chart结构调整）

2. 排查证书签发状态

   • 查看集群中证书的状态：

     kubectl get certificates
     

     找到对应新Host的证书，若状态不是Ready，说明签发失败。
   • 查看验证Pod的日志，定位失败原因：

     kubectl logs cm-acme-http-solver-xxxx
     

     常见原因包括：新域名未解析到集群Ingress Controller的IP、端口80被防火墙拦截、域名处于未备案状态等。

3. 清理旧资源并重新触发签发

   • 删除旧的证书资源，让Cert Manager重新为新Host签发：

     kubectl delete certificate <旧证书名称>
     

   • 若Ingress资源未更新，可强制Helm同步：

     helm upgrade <你的Release名称> <Chart名称> --set ingress.hosts[0].host=xxx.prod.xxx.com --force
     

     --force参数会重启Pod，需评估业务影响后使用

Helm通过独立Release实现多环境隔离，具体操作如下：

1. 准备多环境values文件
   创建两个values文件分别对应开发和生产：

   • dev-values.yaml：配置开发环境参数，比如ingress.hosts[0].host=xxx.dev.xxx.com、副本数1、资源限制较低等
   • prod-values.yaml：配置生产环境参数，比如ingress.hosts[0].host=xxx.prod.xxx.com、副本数3、资源限制更高、开启持久化等

2. 安装不同Release到对应环境

   • 部署开发环境（可选指定独立Namespace）：

     # 创建dev命名空间（首次执行）
     kubectl create namespace dev
     # 安装开发环境Release
     helm install dev-<应用名称> <Chart名称> -n dev -f dev-values.yaml
     

   • 部署生产环境：

     # 创建prod命名空间（首次执行）
     kubectl create namespace prod
     # 安装生产环境Release
     helm install prod-<应用名称> <Chart名称> -n prod -f prod-values.yaml
     

3. 关键注意事项

   • 必须使用不同的Release名称（如dev-xxx和prod-xxx），即使在同一Namespace下，Helm会通过Release前缀区分资源
   • 使用独立Namespace可以做到完全的资源隔离，避免环境间相互影响
   • 后续更新环境时，针对对应Release执行helm upgrade即可，比如更新生产环境：

     helm upgrade prod-<应用名称> <Chart名称> -n prod -f updated-prod-values.yaml
     

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