Go应用在Kubernetes中需声明式部署,关键三点:监听0.0.0.0:8080、配全readiness/liveness探针、Ingress与控制器协同生效;Dockerfile须多阶段构建、禁CGO、非root运行。

Go 应用在 Kubernetes 中不是“发布”而是“声明式部署”——你写好 Deployment、Service、Ingress 等资源定义,kubectl apply 之后,Kubernetes 控制平面会持续协调实际状态与你声明的目标一致。没有“一键发布”按钮,只有配置是否准确、探针是否就绪、网络是否连通这三件事决定服务能否真正对外可用。
Go 二进制必须监听 0.0.0.0:8080,不能是 127.0.0.1:8080
Pod 内容器之间通信走的是 Pod IP,不是 localhost。如果你的 Go 代码写成 http.ListenAndServe("127.0.0.1:8080", nil),Service 流量根本进不来,kubectl get pods 显示 Running,但 kubectl port-forward 或 Ingress 始终 502/503。
- 正确写法是
http.ListenAndServe(":8080", nil)(即监听所有接口) -
EXPOSE 8080在 Dockerfile 里只是文档提示,不强制生效;真正起作用的是 Go 程序绑定地址 - 如果用了
net/http.Server,记得显式设置Addr: ":8080"
readinessProbe 和 livenessProbe 必须配且路径真实存在
Kubernetes 不看进程是否 running,只信 HTTP 返回码。没配探针或路径返回非 200,Pod 会卡在 ContainerCreating 或反复重启。
- Go 代码里至少加两个 handler:
http.HandleFunc("/healthz", ...)和http.HandleFunc("/readyz", ...) -
livenessProbe的initialDelaySeconds建议 ≥30,避免启动慢的应用被误杀 -
readinessProbe的initialDelaySeconds可设为 5–10,让流量晚点进来,等 DB 连上、缓存预热完 - YAML 中
port.number必须和 Go 监听端口一致,比如 Go 听 8080,这里就不能写 80
Ingress 配置前必须确认控制器已就绪且能被外部访问
自定义域名(如 api.example.com)不是靠 Kubernetes 自己解析,而是靠 Ingress 控制器 + 外部 DNS 共同完成。Ingress 资源本身只是个路由规则,没控制器就是废纸。
- 先运行
kubectl get pods -n ingress-nginx,确认有 Running 状态的 Pod;没有就用helm install ingress-nginx ingress-nginx/ingress-nginx装一个 - 再查它的 Service:
kubectl get svc -n ingress-nginx,如果是云环境,TYPE应为LoadBalancer,且EXTERNAL-IP非;裸机环境则需是NodePort,并确保节点防火墙放行该端口 - Ingress YAML 的
host字段必须小写、全匹配(如api.example.com),DNS A 记录必须指向上面拿到的 IP - 别漏掉
spec.rules.http.paths.backend.service.name和.port.name/number,这两个字段要和你的Service名称与端口定义完全一致
Dockerfile 多阶段构建必须禁用 CGO 且用 scratch 或最小 alpine
镜像越小越安全、启动越快。用 golang:alpine 直接跑,等于把编译器、包管理器、shell 全塞进生产环境,既增大攻击面又拖慢冷启动。
- 构建阶段:用
golang:1.22-alpine,加上CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-extldflags "-static"' -o main . - 运行阶段:首选
FROM scratch,只 COPY 二进制;若需 ca-certificates(比如调 HTTPS 外部 API),改用FROM alpine:latest并RUN apk --no-cache add ca-certificates - 务必加
USER 65532:65532,避免以 root 运行;EXPOSE 8080虽非必需,但建议保留,方便人肉理解 - 别在运行镜像里留
sh、apk、curl—— 调试用kubectl debug,不是进容器 exec
最常被跳过的其实是 readinessProbe 路径的逻辑完备性:比如 /readyz 只返回 OK,但实际依赖的 Redis 还没连上。上线前一定要手动 curl http://pod-ip:8080/readyz 验证返回 200,且后端依赖真就绪。否则滚动更新时新 Pod 就绪失败,旧 Pod 被删,整个服务直接不可用。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











