通过Helm Chart为SonarQube配置TLS的问题咨询

问题根源 #

你当前遇到的情况：http://sonar.<company>.com:443能访问但无证书加密，https://sonar.<company>.com直接无法访问，核心原因是Ingress的TLS规则未被正确识别生效，且Ingress Controller的绑定配置缺失。

是否必须用Nginx？ #

不是强制要求，但极度推荐用Nginx Ingress Controller——它是Kubernetes生态里最成熟、适配性最好的Ingress实现，包括SonarQube官方Helm Chart在内的绝大多数Chart都对它做了优化适配。如果用其他Ingress Controller（比如Traefik、云厂商托管的ALB/CLB Ingress），需要对应调整配置，但Nginx是最省心的生产级选择。

要不要开启nginx.enabled: true？ #

先明确：SonarQube官方Chart里的nginx.enabled是用来启动内置的Nginx sidecar容器，而非集群级的Ingress Controller。

• 如果你的集群已经部署了独立的Nginx Ingress Controller（生产环境标准配置），绝对不要开这个参数，会导致端口冲突或路由混乱。
• 如果集群完全没有Ingress Controller，开启它能快速让SonarQube暴露服务，但这只是临时测试方案，不适合生产（缺少集群级Ingress管理、负载均衡能力）。

修复步骤 #

1. 确认集群有可用的Ingress Controller #

执行命令检查：

kubectl get pods -n ingress-nginx

确保有处于Running状态的Pod（若Ingress Controller在其他命名空间，替换对应名称）。如果没有，先部署集群级的Nginx Ingress Controller。

2. 修正Ingress配置 #

你的配置缺少ingressClassName指定，导致TLS规则无法被Ingress Controller识别。修改后的完整配置：

ingress:
  enabled: true
  hosts:
  - name: sonar.<company>.com
    path: /
    pathType: Prefix  # 明确路径匹配规则，避免默认值的不确定性
  annotations:
    nginx.ingress.kubernetes.io/proxy-body-size: "64m"  # 建议开启，防止大文件上传失败
  ingressClassName: nginx  # 关键：绑定到集群的Nginx Ingress Controller
  tls:
  - secretName: sonar-server-tls
    hosts:
    - sonar.<company>.com

3. 验证TLS Secret有效性 #

执行命令确认Secret包含正确的证书和密钥：

kubectl describe secret sonar-server-tls -n <你的SonarQube命名空间>

检查输出是否有tls.crt和tls.key两个字段，且证书域名与sonar.<company>.com完全匹配。

4. 验证Ingress状态 #

更新配置后执行Helm升级：

helm upgrade sonarqube sonarqube/sonarqube -f <你的values文件路径>

等待Pod重启完成后，检查Ingress状态：

kubectl get ingress -n <你的SonarQube命名空间>

查看ADDRESS字段是否有Ingress Controller的公网IP或域名；再执行：

kubectl describe ingress <SonarQube的Ingress名称>

确认TLS部分已正确关联sonar-server-tls Secret。

5. 测试访问 #

最后用https://sonar.<company>.com测试，应该能正常通过HTTPS访问SonarQube，且浏览器显示证书有效。

补充注意事项 #

• 如果用云厂商托管的Ingress Controller（比如AWS ALB、GCP GKE Ingress），需要把ingressClassName改成对应厂商的类名，同时调整TLS配置（比如用云厂商的证书服务托管证书）。
• 生产环境绝对不要依赖SonarQube内置的Nginx sidecar，一定要用集群级的Ingress Controller做统一流量管理。

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