必须用多阶段Dockerfile构建，禁用CGO（CGO_ENABLED=0 GOOS=linux），否则默认动态链接glibc导致Alpine中报“no such file or directory”；运行镜像须用alpine:3.18，健康探针需HTTP型/healthz端点，Gin必须首行设gin.SetMode(gin.ReleaseMode)。
镜像必须用多阶段Dockerfile构建，且禁用CGO
直接用 go run main.go 或单阶段 FROM golang 构建的镜像，在K8s里大概率启动失败——不是崩溃就是 no such file or directory。根本原因是alpine系统不含glibc，而默认开启CGO会链接宿主机动态库。
- 构建阶段用
golang:1.21-alpine，但必须加CGO_ENABLED=0 GOOS=linux - 编译参数要带
-ldflags="-w -s"剥离调试符号，减小体积 - 运行阶段严格用
FROM alpine:3.18，别切回ubuntu或debian - 二进制和configs目录不能打包进镜像，后者应通过
ConfigMap挂载
错误示例：FROM golang:1.21 AS builder → 缺少 CGO_ENABLED=0，镜像在Pod里直接报错退出。
/healthz端点必须存在，且Liveness/Readiness探针要用HTTP类型
K8s默认的 tcpSocket 探针只看端口通不通，但Gin可能已监听8080、路由没注册完、DB连接池为空——此时流量进来必500。生产环境必须暴露轻量HTTP健康端点，并配对应探针。
- 在Gin中加路由：
router.GET("/healthz", func(c *gin.Context) { c.Status(200) }) -
readinessProbe可稍宽松（如initialDelaySeconds: 10），留给DB/Redis初始化时间 -
livenessProbe别设太短（periodSeconds: 5是陷阱），GC或慢SQL易误判为僵死 - 避免在
/healthz里检查MySQL、Redis等下游依赖——那是/readyz的事
常见现象：滚动更新卡住、新Pod状态一直是 Running 但不Ready，基本就是探针没走HTTP或端点没响应。
立即学习“go语言免费学习笔记（深入）”；
评估 Kubernetes 集群安全态势，覆盖 RBAC、工作负载安全、网络策略、基础设施即代码（IaC）、运行时监控和密钥管理等 30 项控制项……
Deployment里必须显式设置gin.ReleaseMode
Gin默认是 debug 模式，会打印详细错误堆栈、自动重载模板、校验中间件顺序——这些在K8s里全是隐患：暴露敏感路径、CPU飙升、日志刷屏OOM。
- 启动代码第一行就得写：
gin.SetMode(gin.ReleaseMode) - 千万别靠环境变量
GIN_MODE=release——某些K8s发行版（如OpenShift）会覆盖它 - 如果用了
gin.Default()，它内部已调用gin.Recovery()和gin.Logger()，但模式仍需手动设
漏掉这句最直接的表现：Pod日志里疯狂刷 [GIN-debug]，CPU使用率虚高，HPA误判为“负载高”而扩副本。
HPA扩容失效？先确认指标源和Gin是否暴露/metrics
K8s 1.23+ 默认HPA只认 cpu 和 memory 这两种Resource指标。想按QPS或P95延迟伸缩，得额外部署 custom-metrics-apiserver + Prometheus Adapter。
- Gin应用自身要集成
promhttp.Handler()，暴露/metrics端点（比如用github.com/prometheus/client_golang/promhttp） - HPA YAML里
metrics字段必须匹配真实指标名，例如：{type: Pods, pods: {metric: {name: http_requests_total}, target: {type: AverageValue, averageValue: 100}}} -
minReplicas别设成1——单点故障下，再高负载也不会触发扩容 - 确认Prometheus能抓到你的Pod：
kubectl port-forward svc/prometheus 9090→ 查http_requests_total{job="my-gin-app"}
最容易被忽略的一点：Gin的 gin.SetMode(gin.ReleaseMode) 必须在 router.Run() 之前执行，否则 /metrics 里的标签、采样逻辑可能异常。
