Docker构建优化：避免大数据库文件重复复制，仅保留指定位置副本

方法1：多阶段构建 + .dockerignore 排除冗余文件 #

这是最稳妥的方案，既能缓存DB层、加速构建，又能确保镜像中仅保留/data目录下的单个数据库文件：

1. 创建/修改.dockerignore文件
   在项目根目录添加规则，禁止将数据库文件复制到源码构建阶段：

my-big-database-file

2. 编写多阶段Dockerfile
   将DB文件准备、Go代码构建、最终镜像打包拆分为独立阶段：

# 阶段1：单独缓存数据库文件（仅当DB变更时重新构建此层）
FROM alpine:latest AS db-cache
COPY my-big-database-file /data/my-big-database-file

# 阶段2：构建Go应用
FROM golang:1.22 AS builder
WORKDIR /src
# 先缓存依赖层，避免代码迭代重复下载依赖
COPY go.mod go.sum ./
RUN go mod download
# 复制源码（因.dockerignore规则，不会包含DB文件）
COPY . ./
# 编译静态二进制
RUN CGO_ENABLED=0 GOOS=linux go build -o /app/my-service .

# 阶段3：最终运行镜像
FROM alpine:latest
WORKDIR /app
# 复制编译好的应用
COPY --from=builder /app/my-service .
# 从缓存阶段复制DB到预期的/data目录
COPY --from=db-cache /data/my-big-database-file /data/my-big-database-file

CMD ["./my-service"]

方法2：无需修改.dockerignore，用COPY --exclude参数（Docker 23.0+） #

如果不想调整.dockerignore，可以利用Docker 23.0及以上版本支持的--exclude参数，在复制源码时直接排除数据库文件：

修改builder阶段的COPY命令：

# 替换原有的COPY . ./
COPY --exclude=my-big-database-file . ./

其余步骤和方法1的多阶段构建一致，同样能避免DB文件被复制到/src/data，最终仅保留/data目录下的副本。

核心逻辑说明 #

• 将DB文件单独放在第一个构建阶段，利用Docker的分层缓存特性，只要DB文件不修改，这一层就会被永久缓存，大幅减少大文件的重复复制时间。
• 通过.dockerignore或--exclude参数，阻止DB文件被带入Go代码构建阶段的/src/data目录，从根源上避免冗余副本。
• 最终镜像仅从DB缓存阶段复制文件到/data，完全符合代码对文件位置的预期，且无需重构源码目录。

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