如何在Kubernetes中部署Go应用并绑定域名-Golang-PHP中文网

go服务需满足三个前提：pod有稳定标签供service selector匹配；service为clusterip类型且targetport与go监听端口一致；服务响应/healthz等健康检查返回2xx。

如何在kubernetes中部署go应用并绑定域名

用 Ingress 暴露 Go 服务并绑定域名

直接靠 Service（哪怕是 LoadBalancer）无法实现域名绑定；必须引入 Ingress 资源，配合 Ingress Controller（如 Nginx、Traefik）才能把请求按 Host 或 Path 路由到后端 Service。

常见错误是只写了 Ingress YAML 却没部署对应的 Ingress Controller，导致 kubectl get ingress 显示 ADDRESS <none></none>，域名始终 503 或超时。

确认集群已安装并运行 ingress-nginx-controller（或你选用的控制器），通常在 ingress-nginx 命名空间下
Ingress 的 spec.rules.host 必须与你实际申请/配置的域名完全一致（区分大小写，不带 http://）
DNS A 记录需指向 Ingress Controller 的 Service 外部 IP（kubectl -n ingress-nginx get svc ingress-nginx-controller 查看 EXTERNAL-IP）

示例 ingress.yaml：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: go-app-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  ingressClassName: nginx
  rules:
  - host: api.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: go-app-service
            port:
              number: 80

Go 应用本身要适配域名访问

很多 Go 服务硬编码了 http.ListenAndServe(":8080", nil)，但 Ingress 默认转发到后端 Service 的 80 端口，而你的 Pod 容器仍监听 8080 —— 这没问题，只要 Service 的 targetPort 正确映射即可。真正容易出问题的是应用内部生成的跳转 URL、静态资源路径或健康检查响应头。

Kubernetes Skills

针对 Kubernetes 仪表板和 Web UI 的浏览器自动化。适用于与 Kubernetes Dashboard、Grafana、ArgoCD UI 或其他 Web 界面交互。需要设置 MCP_BROWSER_ENABLED=true。

下载

避免在 Go 代码里拼接完整 URL（如 "http://localhost:8080/health"），改用相对路径或从 req.Host / req.Header.Get("X-Forwarded-Host") 动态构造
确保 Service 的 port（Ingress 指向的端口）和 targetPort（Pod 容器实际监听端口）匹配，例如：port: 80, targetPort: 8080
如果用了 http.Redirect，注意 req.RequestURI 是原始路径，而 req.URL.Path 已被 Ingress 重写（取决于 rewrite-target 配置）

HTTPS 域名必须配 TLS 证书

浏览器访问 https://api.example.com 时，Ingress Controller 需终止 SSL；否则会返回 400 或连接拒绝。Kubernetes 不自动签发或续期证书，得靠 cert-manager + ACME（如 Let's Encrypt）自动化完成。

先部署 cert-manager（官方 Helm Chart 最稳），再创建 ClusterIssuer（生产环境用 letsencrypt-prod）
Ingress 中添加 tls 字段，并确保 secretName 对应的 Secret 由 cert-manager 自动创建（不要手动创建空 Secret）
ACME HTTP01 挑战要求域名 DNS 解析可达，且 Ingress 的 host 必须能被公网访问到（即 Ingress Controller 的 EXTERNAL-IP 可被 Let's Encrypt 验证服务器访问）

加了 TLS 的 Ingress 片段：

spec:
  tls:
  - hosts:
      - api.example.com
    secretName: api-example-com-tls
  rules:
  - host: api.example.com
    http:
      ...

调试域名不通的三个关键检查点

域名解析正常但服务打不开？别急着改 Go 代码，先验证基础设施链路是否打通：

kubectl get ingress go-app-ingress -o wide 看 ADDRESS 是否有值；没有说明 Ingress Controller 没生效或未就绪
kubectl -n ingress-nginx logs deploy/ingress-nginx-controller --tail=20 查看是否有 “no endpoints available” 或 “upstream denied” 类错误
kubectl get endpoints go-app-service 确认 SUBSETS.ADDRESSES 不为空；为空代表 Pod 没通过 readinessProbe，Ingress Controller 不会把流量转过去

最常被忽略的是 readinessProbe 配置错误——比如路径写成 /health 但 Go 服务只实现了 /ready，导致 Endpoint 始终为空，Ingress 流量进不来，域名自然“通但无响应”。