Notes from a 2 AM On-Call: Why Gitea's Docker Build Ate 40 Minutes (And the 3-Line BuildKit Fix)

说明与用途

在 Gitea 的 Dockerfile 中重新排序 ARG，恢复了 96% 的缓存命中率，将构建时间从 40 分钟降至 8 分钟，节省了 68% 的 CI 资源。

问题

Gitea self-hosted CI Docker builds suddenly grew from 8 min to 40 min due to repeated re‑downloading of Go module dependencies, despite no code changes.

结果

Reordering ARGs in Dockerfile restored 96 % cache hit rate, cutting build time from 40 min to 8 min and reducing weekly CI cost by 68 %.

工作流

• 1. Identify cache miss on go mod download step via GitHub Actions logs.
• 2. Inspect Dockerfile for ARG ordering; find ARG GITEA_VERSION before WORKDIR and COPY.
• 3. Move volatile ARGs after dependency layers in Dockerfile.
• 4. Pin action versions and BuildKit image, scope cache by branch, and set build‑args.
• 5. Re‑run build; observe cache hit and reduced time.

证据

Step 12/18 : RUN go mod download ---> Running in 3a8f9c2d1e4b go: downloading github.com/... [... 2,847 dependencies streaming ...] time: 38m 42s

来源

Gitea's Dockerfile had a subtle ARG ordering bug that invalidated BuildKit's layer fingerprinting.

来源

Result: Build time dropped back to 7m 54s. Cache hit rate jumped from 12% to 96%.

来源