仅需三个步骤即可构建最小的 Docker 映像
Go——仅需三个步骤即可构建最小的 Docker 映像
当您为 docker 构建 Go 应用程序时,通常从诸如 golang:1.13
之类的映像开始。但将这个映像实际运行时会浪费资源。让我们看一下如何将 Go 应用程序构建为绝对最小的 Docker 映像。
1. 选择 Go 版本
尽管使用 golang:latest
或者 仅使用 golang
的版本镜像很诱人,但由于各种问题,这样做都不太好,其中主要的一个问题是这样做构建(可能)不具有重复性。无论是开发测试需要部署产品时使用的相同版本(的镜像),还是你发现自己需要修补旧版本(镜像)的应用程序,最好将 Go 发行版镜像的版本固定,只有当你知道你需要更新 Go 版本的时候你再去更新它。
因此,需要一直使用完整的说明,包含补丁版本号,而且最好说明镜像的基本系统,比如:1.13.0-alpine3.10
。
2. 保持最小
这个最小包含两个方面:
- 最短构建时间
- 最小产出镜像
快速构建
Docker 为您缓存中间层,因此如果您正确地构造 Dockerfile,您可以减少每次(更改后)后续重建所需的时间。根据经验来说,根据命令的源(例如:COPY
源)更改的频率对命令进行排序。
另外,请考虑使用 .dockerignore
文件,该文件有助于保持构建上下文较小——当您执行 docker build
时,docker 需要将当前目录中的所有内容都提供给构建 docker 守护进程(即在 docker 构建开始时向 docker 守护进程发送构建上下文)。简单来说,如果你的代码仓库包含了很多构建你的程序所不需要的数据(比如测试,markdown 格式文档生成等),.dockerignore
将有助于加快构建速度。
至少,您可以从下边的示例内容开始尝试。如果你 COPY . .
,Dockerfile 就会进入上下文中(不应该这样做),当你只修改 Dockerfile 时,不需要执行并使所有的东西无效。
.git
Dockerfile
testdata
最小镜像
最简单的手段是使用 scratch
(构建基础镜像),没有其他手段能与之相比。Scratch 是特殊的 base
(基础)镜像,它不是一个真正的镜像,而是一个完全空的系统。注意:在老版本 docker 中,显式的 scratch 镜像作为一个真正的镜像层,docker 1.5
之后的版本就不再是这样。
你的 Dockerfile 只需两步:
- 基于一个镜像(比如
builder
镜像,你想叫什么都行,编译你的应用程序; - 然后将编译产出的二进制程序和所有其他依赖拷贝到基于 scratch 的镜像中;
这样做贼管用!
3. 放在一起
看看完整的 Dockerfile 长啥样:
FROM golang:1.13.0-stretch AS builder
ENV GO111MODULE=on \
CGO_ENABLED=1
WORKDIR /build
# 缓存 mod 检索-那些不常更改的模块
COPY go.mod .
COPY go.sum .
RUN Go mod download
# 复制构建应用程序所需的代码
# 可能需要更改下边的命令,只复制您实际需要的内容。
COPY . .
# 构建应用程序
RUN Go build ./cmd/my-awesome-go-program
# 我们创建一个 /dist 目录, 仅包含运行时必须的文件
# 然后,他会被复制到输出镜像的 / (根目录)
WORKDIR /dist
RUN cp /build/my-awesome-go-program ./my-awesome-go-program
# 可选项:如果您的应用程序使用动态链接(通常情况下使用 CGO),
# 这将收集相关库,以便稍后将它们复制到最终镜像
# 注意: 确保您遵守您复制和分发的库的许可条款
RUN ldd my-awesome-go-program | tr -s '[:blank:]' '\n' | grep '^/' | \
xargs -I % sh -c 'mkdir -p $(dirname ./%); cp % ./%;'
RUN mkdir -p lib64 && cp /lib64/ld-linux-x86-64.so.2 lib64/
# 在运行时复制或创建您的应用程序需要的其他目录/文件。
# 例如,本例使用 /data 作为工作目录,在正常运行容器时,该目录可能绑定到永久目录
RUN mkdir /data
# 构建最小运行时镜像
FROM scratch
COPY --chown=0:0 --from=builder /dist /
# 设置应用程序以 /data 文件夹中的非 root 用户身份运
# User ID 65534 通常是 'nobody' 用户.
# 映像的执行者仍应在安装过程中指定一个用户。
COPY --chown=65534:0 --from=builder /data /data
USER 65534
WORKDIR /data
ENTRYPOINT ["/my-awesome-go-program"]
如果您觉得这些功能有用,或者想要分享一些自己的方法或技巧,请在下边发表评论。
- 原文作者:战神西红柿
- 原文链接:https://tomatoares.github.io/posts/go/translated/3-step-build-minix-image/
- 版权声明:本作品采用知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议进行许可,非商业转载请注明出处(作者,原文链接),商业转载请联系作者获得授权。