Traefik与GitHub Actions协同自动部署有四种方法:一、构建推送镜像并远程更新服务;二、更新Kubernetes清单并kubectl应用;三、调用Traefik API触发配置重载;四、生成同步静态配置后发送重载信号。

GitHub Actions 里怎么触发 Kubernetes 部署
关键不是“能不能”,而是“谁来执行 kubectl”。GitHub 托管的 runner 默认没有 kubectl,也不连你集群的 kubeconfig,所以直接写 kubectl apply -f deploy.yaml 会报错:command not found 或 Unable to connect to the server。
必须显式配置两件事:安装 kubectl(或用 azure/k8s-bake、google-github-actions/setup-gcloud 等封装好的 action),以及安全注入集群凭证。
- 用
google-github-actions/setup-gcloud+gcloud container clusters get-credentials(GKE) - 用
azure/login+azure/aks-set-context(AKS) - 手动 base64 解码
KUBECONFIG机密并写入文件(通用,但需确保私钥权限为600)
Go 项目镜像构建和推送必须和部署解耦
很多人把 docker build、docker push、kubectl apply 全塞进一个 job,结果失败后难定位——是镜像没推成功?还是 YAML 路径写错了?还是 namespace 不存在?
推荐拆成两个 job:build-and-push 和 deploy-to-k8s,用 needs 控制依赖,并在 deploy-to-k8s 中只拉取已知存在的镜像标签(比如 ${{ github.sha }} 或 ${{ github.event.inputs.tag }})。
立即学习“go语言免费学习笔记(深入)”;
-
build-and-push成功后,把镜像地址(如ghcr.io/your-org/app:${{ github.sha }})存为artifact或通过output传给下游 -
deploy-to-k8s的DeploymentYAML 必须用image:字段引用该镜像,不能硬编码latest - 如果用 Helm,确保
CHART_PATH指向正确的目录,且 values 文件中image.repository和image.tag可被覆盖
Go 应用的 Kubernetes 配置容易漏掉三个关键点
哪怕镜像能跑起来,服务也可能在滚动更新时中断、健康检查失败、或者 OOM 被杀。这不是 GitHub Actions 的问题,而是 Go 应用本身和 Kubernetes 的交互细节没对齐。
-
livenessProbe和readinessProbe的initialDelaySeconds必须大于 Go 应用冷启动耗时(比如 DB 连接、配置加载),否则 Pod 会被反复重启 -
resources.requests和resources.limits必须设——Go 程序默认不限内存,Kubernetes 可能因节点压力直接 kill 容器而不等Shutdown() -
terminationGracePeriodSeconds建议设为30以上,给 Go 的server.Shutdown()留出足够时间处理长连接和清理资源
为什么用多阶段 Dockerfile 后,GitHub Actions 还是构建慢
因为默认每次都会重新 go mod download,哪怕 go.mod 没变。Docker 构建缓存在本地有效,但在 GitHub Actions runner 上是干净环境,缓存不跨 job、不跨 runner。
解决方法不是关掉缓存,而是主动利用 GitHub Actions 的 actions/cache 缓存 go mod 下载的包:
steps:
- uses: actions/checkout@v4
- name: Set up Go
uses: actions/setup-go@v5
with:
go-version: '1.21'
- name: Cache Go modules
uses: actions/cache@v4
with:
path: ~/go/pkg/mod
key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
- name: Build binary
run: CGO_ENABLED=0 GOOS=linux go build -o main ./cmd/api注意:hashFiles('**/go.sum') 是关键——只要依赖没变,缓存就命中;一旦 go.sum 改了,缓存自动失效,避免旧包污染新构建。
真正容易被忽略的,是 Go 应用里没实现 SIGTERM 捕获,或者 Shutdown() 超时时间设得太短。Kubernetes 发出终止信号后,如果应用 30 秒内没退出,它会发 SIGKILL 强杀——这时候连接中断、事务回滚、日志丢失,全看运气。


















