Golang服务容器化部署到Kubernetes必须先构建静态二进制镜像(CGO_ENABLED=0+GOOS=linux多阶段构建),配置readiness/liveness探针、资源限制及0.0.0.0监听,并通过Deployment声明式部署。

确认Golang服务是否已容器化
没打包成镜像就上K8s,等于把源码直接扔进生产环境——K8s调度的是容器,不是go run main.go。必须先有可运行的Docker镜像。
常见错误:本地能跑,但镜像里缺CGO_ENABLED=0导致编译出带动态链接的二进制,进容器就报no such file or directory(实际是找不到libc.so)。
- 用
FROM golang:1.22-alpine做构建阶段,FROM alpine:3.19做运行阶段,确保静态编译 -
go build -a -ldflags '-extldflags "-static"' -o /app/server .(加-a强制重编所有依赖) - 镜像里只保留
/app/server和必要配置文件,别挂载src/或go.mod
编写最小可用的Deployment YAML
K8s不认main.go,只认YAML里定义的image、ports、livenessProbe这些字段。漏掉健康检查,服务上线后可能被Service持续转发流量到已卡死的Pod。
典型配置差异:本地开发用:8080,K8s里必须显式声明containerPort: 8080,否则Service无法正确转发;且livenessProbe.httpGet.port必须写数字端口,不能写name: http(除非你真在ports里定义了name)。
立即学习“go语言免费学习笔记(深入)”;
- 用
env:注入ENV=production,别靠os.Getenv("ENV")硬编码判断 -
resources.limits.memory至少设64Mi,否则某些集群的OOMKilled阈值会误杀小内存Go进程 - 避免写
command: ["./server"],优先用镜像CMD,防止覆盖ENTRYPOINT
Service与Ingress怎么连通Golang HTTP服务
Go服务监听localhost:8080?立刻改掉。K8s Pod内网是扁平IP,必须监听0.0.0.0:8080,否则Service的ClusterIP流量进不来。
常见错误现象:kubectl get endpoints显示ENDPOINTS为空,说明Pod没通过readinessProbe,而probe失败往往是因为服务根本没在0.0.0.0上监听。
-
readinessProbe.httpGet.path建议设为/healthz,用http.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(200) })实现,别用/(可能触发业务逻辑阻塞) - Ingress需要
service.port.number匹配Deployment里containerPort,不支持用名字映射(除非用service.port.name且Deployment中明确定义了name) - 若用
LoadBalancer类型Service,注意云厂商SLB默认超时是60秒,长连接需在Go里设http.Server.ReadTimeout和WriteTimeout
日志与调试:为什么fmt.Println在Pod里看不到
K8s默认捕获stdout和stderr,但Go程序如果把日志写进文件(比如log.SetOutput(f)),kubectl logs就完全抓不到。线上排查全靠stdout。
另一个坑:log.Printf输出没带时间戳,多个goroutine并发打日志时顺序混乱,看不出执行流。
- 删掉所有
os.OpenFile写日志的逻辑,统一走fmt.Println或log.Printf - 用
log.SetFlags(log.LstdFlags | log.Lmicroseconds | log.Lshortfile)增强可读性 - 调试时别只看
kubectl logs pod-name,加-c container-name(多容器场景)、--previous(崩溃重启前的日志) - 若服务启动即退出,先
kubectl describe pod看Events里的FailedCreatePodContainer或CrashLoopBackOff原因
Go二进制的pprof接口(/debug/pprof/)暴露在Pod内网即可,别通过Ingress暴露——这等于把性能分析入口直接放公网。


















