Go程序上K8s需确保镜像精简（CGO_ENABLED=0、-ldflags="-s -w"、distroless基础镜像）、配置liveness/readiness探针（/health与/ready端点、合理initialDelaySeconds）及优雅关闭（监听SIGTERM、server.Shutdown）。
直接发布 Go 程序到 Kubernetes 集群，核心不是“能不能”，而是“镜像是否干净、探针是否就绪、资源是否受控”。跳过构建优化或忽略信号处理，上线后大概率会遇到 CrashLoopBackOff、Readiness probe failed 或 Pod 启动慢等现象。
用多阶段 Dockerfile 构建最小化镜像
Go 静态编译的特性必须被真正利用起来，否则镜像里塞进 Go 运行时、调试符号、源码甚至 git 工具，体积轻松破百 MB，还带安全隐患。
-
CGO_ENABLED=0必须设，避免动态链接 libc；GOOS=linux明确目标平台 -
-ldflags="-s -w"去掉符号表和调试信息，二进制可缩小 30%～50% - 运行阶段别用
alpine就完事——gcr.io/distroless/static-debian12更安全，无 shell、无包管理器，攻击面更小 -
COPY --from=builder只复制最终二进制，不带go.mod、main.go或任何中间产物
Deployment 中必须配置 liveness 和 readiness 探针
没有探针的 Go 服务在 Kubernetes 里等于“盲跑”：K8s 不知道它是否真能收请求，也不知道它是否已准备好接管流量。常见错误是只写 httpGet 路径，却不校验返回状态码或超时逻辑。
-
livenessProbe应该指向一个轻量健康检查端点（如/health），失败后 K8s 会重启容器 -
readinessProbe要更谨慎，比如/ready需确认数据库连接、缓存初始化完成，否则新 Pod 会提前加入 Service 的 Endpoint，导致 5xx -
initialDelaySeconds要留足启动时间；Go 程序冷启动快，但若加载配置、迁移 DB 或拉取远程密钥，5 秒可能不够
Go 程序自身要响应 SIGTERM 实现优雅关闭
Kubernetes 发送 SIGTERM 后默认等待 30 秒才强制 SIGKILL。如果 Go 程序没监听这个信号，正在处理的 HTTP 请求会被突然中断，客户端收到 connection reset。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 用
signal.Notify(c, os.Interrupt, syscall.SIGTERM)捕获终止信号 -
server.Shutdown(ctx)是关键：它会先关闭 listener，再等待活跃请求完成（需配合 context timeout） - 不要在
Shutdown前调用os.Exit(0)，这会让 graceful shutdown 失效 - 若用了第三方库（如
gin、echo），确认其Run方法是否内置了信号处理，否则得自己 wrap
资源限制与镜像标签必须具体化
resources.limits 缺失会导致节点资源争抢；用 latest 标签则无法回滚、不可审计、CI/CD 流水线不稳定。
- 内存限制建议从
128Mi（开发）起步，生产环境至少512Mi；Go 的 GC 在内存紧张时会频繁触发，影响延迟 - CPU
requests设太低（如10m）会导致调度困难；limits设太高（如2）可能被限频，反而降低吞吐 - 镜像 tag 必须是语义化版本（如
v1.2.3）或 Git commit hash（如sha-abc123），禁用latest - Secret 和 ConfigMap 的挂载路径、权限（
readOnly: true）、键名大小写都要和 Go 程序读取逻辑严格一致，否则配置加载失败静默发生
最常被跳过的环节其实是日志输出格式和信号处理逻辑——它们不报错，但会让问题排查变成盲人摸象。Kubernetes 不关心你的程序多优雅，只认探针返回码、退出状态和资源使用曲线。把这三件事做实，发布才算真正落地。
