gitlab ci是ci/cd工具而非版本控制系统，需与git协同：git负责代码版本管理，gitlab ci通过.gitlab-ci.yml定义流水线，依赖golang镜像构建、go mod tidy校验、多阶段docker打包、私有registry推送及k8s健康探针部署。
GitLab CI 不是版本控制系统，而是持续集成/持续交付（CI/CD）工具。它本身不替代 Git，而是监听 Git 仓库（如 GitLab 自托管或托管仓库）的代码变更，自动触发构建、测试、部署流程。如果你的目标是“用 GitLab 管理 Golang 微服务代码，并通过 GitLab CI 实现自动化部署”，那方案完全可行——但需厘清角色：Git 做版本控制，GitLab CI 做自动化流水线。
gitlab-ci.yml 中必须声明 Go 运行时与构建环境
GitLab Runner 默认不带 Go 环境，直接写 go build 会报 command not found: go。不能依赖系统预装，必须显式指定镜像或安装 Go。
- 推荐使用官方
golang:1.21-alpine或golang:1.22镜像，轻量且含完整工具链 - 若需多阶段构建（如最终镜像用
distroless），应在buildjob 中用golang镜像编译，再在dockerjob 中用docker:dind构建并推送镜像 - 避免在
before_script中反复curl安装 Go —— 不稳定、慢、易因网络失败中断流水线
go mod tidy 和测试必须在构建前执行
go mod tidy 不只是整理依赖，它会校验 go.sum 是否被篡改；跳过这步可能导致本地能跑、CI 失败，或更严重地引入不一致依赖。
- 务必在
test和build之前运行go mod tidy -v，并加上set -e保证失败即终止 -
go test -v ./...应包含-race（尤其微服务常并发处理请求），但注意-race仅支持linux/amd64和linux/arm64 - 不要忽略
GOOS=linux GOARCH=amd64—— 即使本地是 macOS，CI 构建目标必须是 Linux，否则二进制无法在容器中运行
Docker 镜像构建与推送需分离权限与阶段
把构建镜像和推送镜像放在同一个 job 容易因权限或网络问题导致部分成功（镜像建好了但没推上去），后续部署却拉不到新版本。
- 用
docker:dind服务时，必须开启DOCKER_HOST: tcp://docker:2375并配置services: [docker:dind] - 镜像 tag 建议用
$CI_COMMIT_SHORT_SHA或$CI_ENVIRONMENT_SLUG，避免全用latest—— Kubernetes 无法感知latest变更，可能不触发滚动更新 - 推送前务必验证镜像是否存在：
docker images | grep myservice，防止静默失败 - 私有 Registry（如 Harbor）需提前在 GitLab 设置
CI_REGISTRY_USER和CI_REGISTRY_PASSWORD，且在docker login后才docker push
Kubernetes 部署环节最容易漏掉健康探针配置
很多 Golang 微服务在 CI 流水线里顺利构建、推送、kubectl apply 成功，但 Pod 一直卡在 ContainerCreating 或反复重启——根本原因是缺少 livenessProbe / readinessProbe，K8s 认为服务未就绪，拒绝转发流量，甚至触发重启。
- Golang 服务必须暴露
/healthz或类似 HTTP 健康端点（哪怕只返回200 OK），并在 Deployment 中配置httpGet探针 -
initialDelaySeconds不能设太小（比如 1），Golang 应用冷启动可能需 2–5 秒加载配置、连接 DB；建议从 10 开始调优 - 不要省略
resources.requests—— 某些 K8s 集群（如 Openshift）强制要求，缺失会导致 Pod 创建失败 - 用
kubectl rollout status deployment/myservice替代简单kubectl apply，确保滚动更新真正完成再结束流水线
GitLab CI 的真实复杂度不在语法，而在各环节之间的状态传递与失败兜底：镜像 tag 是否唯一、Registry 凭据是否过期、K8s context 是否切换正确、probe 超时阈值是否匹配实际启动耗时——这些细节不出现在 .gitlab-ci.yml 的缩进里，却决定一次部署是秒级上线还是凌晨告警。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
