如何避免Go模块缓存存入Docker镜像并复用主机缓存？

要实现复用主机（开发机/Jenkins代理）的Go模块缓存与构建缓存，同时保证最终镜像不包含这些缓存，你可以借助**Docker BuildKit的绑定挂载（bind mount）**特性，在构建阶段临时挂载主机的Go缓存目录，既复用已有缓存，又不会将缓存写入镜像层。

核心思路 #

Docker BuildKit支持在RUN指令中通过--mount=type=bind临时挂载主机目录到容器内，构建时Go工具直接读写主机的缓存目录，后续构建可直接复用已有缓存；这些挂载的内容不会被打包进最终镜像，同时配合多阶段构建可得到精简的Hugo应用镜像。

具体实现步骤 #

1. 开启Docker BuildKit

BuildKit是Docker的新一代构建引擎，默认可能未启用，可通过以下方式开启：

• 临时开启：构建时添加环境变量DOCKER_BUILDKIT=1
• 永久开启：修改Docker配置文件/etc/docker/daemon.json，添加"features": {"buildkit": true}，重启Docker服务

2. 编写Dockerfile

以下是结合多阶段构建与主机缓存挂载的示例：

# 第一阶段：Go程序编译与页面生成
FROM golang:1.22 AS builder

# 明确Go缓存路径（与主机路径对应，方便挂载）
ENV GOMODCACHE=/go/pkg/mod
ENV GOCACHE=/root/.cache/go-build

# 复制项目代码与模板文件
COPY . /app
WORKDIR /app

# 挂载主机的Go模块缓存和构建缓存，执行Go命令
RUN --mount=type=bind,source=${HOME}/go/pkg/mod,target=${GOMODCACHE} \
    --mount=type=bind,source=${HOME}/.cache/go-build,target=${GOCACHE} \
    go mod download && \
    go run ./page-generator.go  # 假设你的Go生成程序是page-generator.go

# 第二阶段：构建最终Hugo应用镜像
FROM hugo:extended AS final

# 从构建阶段复制生成的页面到Hugo站点目录
COPY --from=builder /app/public /usr/share/nginx/html  # 可根据Hugo配置调整路径

3. 执行构建命令

构建时需传递主机的HOME路径作为构建参数，确保挂载路径正确：

DOCKER_BUILDKIT=1 docker build --build-arg HOME=${HOME} -t my-hugo-app .

Jenkins代理环境适配 #

在Jenkins代理中执行构建时，需注意：

• 确保Jenkins用户的Go缓存目录（${JENKINS_HOME}/go/pkg/mod、${JENKINS_HOME}/.cache/go-build）存在且有读写权限
• 构建时将HOME参数设置为Jenkins用户的主目录，比如：

  DOCKER_BUILDKIT=1 docker build --build-arg HOME=${JENKINS_HOME} -t my-hugo-app .
  

方案优势 #

• 完全复用主机已有的Go模块与构建缓存，大幅缩短构建时间
• 挂载的缓存目录不会被写入镜像层，最终镜像体积不受缓存影响
• 结合多阶段构建，可得到仅包含Hugo应用的精简镜像

内容的提问来源于stack exchange，提问作者Marco