如何给go项目打最小docker镜像，足足降低99%

已于 2024-02-22 15:00:23 修改
阅读量10w+ 收藏 5
点赞数 2
分类专栏： Docker 文章标签： golang docker
于 2021-10-14 11:00:00 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Scoful/article/details/120729102
版权

目录

1. 直接编译得到运行文件 22M

使用的项目源码地址
本地直接编译打一个linux运行包

set GOOS=linux
set GOARCH=amd64
go build main.go

在这里插入图片描述
结果是22M

2. 不编译直接运行的镜像 941M

Dockerfile文件内容

# 基础镜像，基于golang最新镜像构建
FROM golang
# 作者
MAINTAINER scoful
# 全局工作目录
WORKDIR $GOPATH/kingProject
# 把运行Dockerfile文件的当前目录所有文件复制到目标目录
COPY . $GOPATH/kingProject
# 环境变量
#  用于代理下载go项目依赖的包
ENV GOPROXY https://goproxy.cn,direct
# 需暴露的端口
EXPOSE 8888
# 可外挂的目录
VOLUME ["/go/kingProject/config","/go/kingProject/log"]
# docker run命令触发的真实命令(相当于不编译打包，源代码直接运行)
ENTRYPOINT ["go","run","main.go"]

编译镜像后查询结果如下：
在这里插入图片描述
结果是941M，基本跟基础镜像golang的大小一致，而且因为没有预先编译，等到运行的时候再编译并拉取依赖包，run起来很慢

3. 编译后的镜像 1.14G

Dockerfile文件内容

# 基础镜像，基于golang最新镜像构建
FROM golang
# 作者
MAINTAINER scoful
# 全局工作目录
WORKDIR $GOPATH/kingProject
# 把运行Dockerfile文件的当前目录所有文件复制到目标目录
COPY . $GOPATH/kingProject
# 环境变量
#  用于代理下载go项目依赖的包
ENV GOPROXY https://goproxy.cn,direct
# 编译
RUN GOOS=linux GOARCH=amd64 go build main.go
# 需暴露的端口
EXPOSE 8888
# 可外挂的目录
VOLUME ["/go/kingProject/config","/go/kingProject/log"]
# docker run命令触发的真实命令(相当于直接运行编译后的可运行文件)
ENTRYPOINT ["./main"]

在这里插入图片描述
结果是1.14G，更大了，因为加上了编译过程中拉取的包，但是预先编译，所以直接run，速度很快

4. 优化：使用alpine版本的基础镜像 517M

优化的方向：如果一个镜像在https://hub.docker.com/里能搜到有alpine版本，尽量用alpine版本，相当于是官方提供的最小化可用版本

Dockerfile文件内容

# 基础镜像，基于golang的alpine版本镜像构建
FROM golang:alpine
# 作者
MAINTAINER scoful
# 全局工作目录
WORKDIR $GOPATH/kingProject
# 把运行Dockerfile文件的当前目录所有文件复制到目标目录
COPY . $GOPATH/kingProject
# 环境变量
#  用于代理下载go项目依赖的包
ENV GOPROXY https://goproxy.cn,direct
# 编译
RUN GOOS=linux GOARCH=amd64 go build main.go
# 需暴露的端口
EXPOSE 8888
# 可外挂的目录
VOLUME ["/go/kingProject/config","/go/kingProject/log"]
# docker run命令触发的真实命令(相当于直接运行编译后的可运行文件)
ENTRYPOINT ["./main"]

在这里插入图片描述
结果是517M，比1.14G减少了650.36M，直接降了56%，而且run一样很快

5. 再优化：使用多级构建的镜像 28.4M

再优化的方向：go项目其实只是在build的阶段需要go环境，run的时候是不需要的，那build完后go环境用个alpine版本就行

Dockerfile文件内容

# 基础镜像，基于golang的alpine镜像构建--编译阶段
FROM golang:alpine AS builder
# 作者
MAINTAINER scoful
# 全局工作目录
WORKDIR /go/kingProject
# 把运行Dockerfile文件的当前目录所有文件复制到目标目录
COPY . /go/kingProject
# 环境变量
#  用于代理下载go项目依赖的包
ENV GOPROXY https://goproxy.cn,direct
# 编译，关闭CGO，防止编译后的文件有动态链接，而alpine镜像里有些c库没有，直接没有文件的错误
RUN GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build main.go

# 使用alpine这个轻量级镜像为基础镜像--运行阶段
FROM alpine AS runner
# 全局工作目录
WORKDIR /go/kingProject
# 复制编译阶段编译出来的运行文件到目标目录
COPY --from=builder /go/kingProject/main .
# 复制编译阶段里的config文件夹到目标目录
COPY --from=builder /go/kingProject/config ./config
# 需暴露的端口
EXPOSE 8888
# 可外挂的目录
VOLUME ["/go/kingProject/config","/go/kingProject/log"]
# docker run命令触发的真实命令(相当于直接运行编译后的可运行文件)
ENTRYPOINT ["./main"]

在这里插入图片描述
结果是28.4M，比517M减少了488.6M，再降95%，那个533M是第一级构建生成的

6. 再再优化：使用多级构建+scratch基础镜像 22.8M

再再优化的方向：再极端一点，第二级构建的时候用个空镜像来当基础镜像

Dockerfile文件内容

# 基础镜像，基于golang的alpine镜像构建--编译阶段
FROM golang:alpine AS builder
# 作者
MAINTAINER scoful
# 全局工作目录
WORKDIR /go/kingProject
# 把运行Dockerfile文件的当前目录所有文件复制到目标目录
COPY . /go/kingProject
# 环境变量
#  用于代理下载go项目依赖的包
ENV GOPROXY https://goproxy.cn,direct
# 编译，关闭CGO，防止编译后的文件有动态链接，而alpine镜像里有些c库没有，直接没有文件的错误
RUN GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build main.go


# 使用scratch这个空镜像为基础镜像--运行阶段
FROM scratch AS runner
# 全局工作目录
WORKDIR /go/kingProject
# 复制编译阶段编译出来的运行文件到目标目录
COPY --from=builder /go/kingProject/main .
# 复制编译阶段里的config文件夹到目标目录
COPY --from=builder /go/kingProject/config ./config
# 需暴露的端口
EXPOSE 8888
# 可外挂的目录
VOLUME ["/go/kingProject/config","/go/kingProject/log"]
# docker run命令触发的真实命令(相当于直接运行编译后的可运行文件)
ENTRYPOINT ["./main"]

在这里插入图片描述
结果是22.8M，已经约等于不用镜像直接编译出的可执行文件大小了，比28.4M减少了5.6M，再降20%，但用scratch当基础镜像的坏处是没法exec进入容器内部，因为真的就是空镜像，啥都没有，啥都不支持

7. 再再再优化：go编译命令去掉冗余输出 16.3M

再再再优化的方向：再再极端一点，go编译的时候，加上参数 -ldflags="-w -s"，直接去掉一些冗余输出内容

Dockerfile文件内容

# 基础镜像，基于golang的alpine镜像构建--编译阶段
FROM golang:alpine AS builder
# 作者
MAINTAINER scoful
# 全局工作目录
WORKDIR /go/kingProject
# 把运行Dockerfile文件的当前目录所有文件复制到目标目录
COPY . /go/kingProject
# 环境变量
#  用于代理下载go项目依赖的包
ENV GOPROXY https://goproxy.cn,direct
# 编译，关闭CGO，防止编译后的文件有动态链接，而alpine镜像里有些c库没有，直接没有文件的错误
RUN GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -ldflags="-w -s" main.go


# 使用scratch这个空镜像为基础镜像--运行阶段
FROM scratch AS runner
# 全局工作目录
WORKDIR /go/kingProject
# 复制编译阶段编译出来的运行文件到目标目录
COPY --from=builder /go/kingProject/main .
# 复制编译阶段里的config文件夹到目标目录
COPY --from=builder /go/kingProject/config ./config
# 需暴露的端口
EXPOSE 8888
# 可外挂的目录
VOLUME ["/go/kingProject/config","/go/kingProject/log"]
# docker run命令触发的真实命令(相当于直接运行编译后的可运行文件)
ENTRYPOINT ["./main"]

在这里插入图片描述
结果是16.3M，看似比不用镜像直接编译出的可执行文件还小，那是因为直接编译没有加上这个参数，如果加上大小还是差不多的，比22.8M减少了6.5M，再降29%，好了，降无可降了，用1.14G来对比的话，减少了1.12G，足足降了99%，鹅妹子嘤！

8. 最终版：顺便解决时区问题 16.3M

Dockerfile文件内容

# 基础镜像，基于golang的alpine镜像构建--编译阶段
FROM golang:alpine AS builder
# 作者
MAINTAINER scoful
# 全局工作目录
WORKDIR /go/kingProject
# 把运行Dockerfile文件的当前目录所有文件复制到目标目录
COPY . /go/kingProject
# 环境变量
#  用于代理下载go项目依赖的包
ENV GOPROXY https://goproxy.cn,direct
# 编译，关闭CGO，防止编译后的文件有动态链接，而alpine镜像里有些c库没有，直接没有文件的错误
RUN GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -ldflags="-w -s" main.go
RUN echo "https://mirrors.aliyun.com/alpine/v3.8/main/" > /etc/apk/repositories \
    && echo "https://mirrors.aliyun.com/alpine/v3.8/community/" >> /etc/apk/repositories \
    && apk add --no-cache tzdata \
    && cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime  \
    && echo Asia/Shanghai > /etc/timezone \
    && apk del tzdata

# 使用scratch这个空镜像为基础镜像--运行阶段
FROM scratch AS runner
# 全局工作目录
WORKDIR /go/kingProject
# 复制编译阶段编译出来的运行文件到目标目录
COPY --from=builder /go/kingProject/main .
# 复制编译阶段里的config文件夹到目标目录
COPY --from=builder /go/kingProject/config ./config
# 复制编译阶段里的时区文件到目标目录
COPY --from=builder /etc/localtime /etc/localtime
COPY --from=builder /etc/timezone /etc/timezone
# 需暴露的端口
EXPOSE 8888
# 可外挂的目录
VOLUME ["/go/kingProject/config","/go/kingProject/log"]
# docker run命令触发的真实命令(相当于直接运行编译后的可运行文件)
ENTRYPOINT ["./main"]

9. 最最推荐使用版：多级+alpine 21.9M

综上所述，scratch镜像有它的缺陷，是一个真的空镜像，不支持很多命令，比如cp，sh等，如果要进入容器内部查东西，都进不去，不适合真实情况，所以还是推荐alpine镜像，很小5M多，可以接受。

Dockerfile文件内容

# 基础镜像，基于golang的alpine镜像构建--编译阶段
FROM golang:alpine AS builder
# 作者
MAINTAINER scoful
# 全局工作目录
WORKDIR /go/kingProject
# 把运行Dockerfile文件的当前目录所有文件复制到目标目录
COPY . /go/kingProject
# 环境变量
#  用于代理下载go项目依赖的包
ENV GOPROXY https://goproxy.cn,direct
# 编译，关闭CGO，防止编译后的文件有动态链接，而alpine镜像里有些c库没有，直接没有文件的错误
RUN GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -ldflags="-w -s" main.go


# 使用alpine这个轻量级镜像为基础镜像--运行阶段
FROM alpine AS runner
# 全局工作目录
WORKDIR /go/kingProject
# 复制编译阶段编译出来的运行文件到目标目录
COPY --from=builder /go/kingProject/main .
# 复制编译阶段里的config文件夹到目标目录
COPY --from=builder /go/kingProject/config ./config
# 将时区设置为东八区
RUN echo "https://mirrors.aliyun.com/alpine/v3.8/main/" > /etc/apk/repositories \
    && echo "https://mirrors.aliyun.com/alpine/v3.8/community/" >> /etc/apk/repositories \
    && apk add --no-cache tzdata \
    && cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime  \
    && echo Asia/Shanghai > /etc/timezone \
    && apk del tzdata
# 需暴露的端口
EXPOSE 8888
# 可外挂的目录
VOLUME ["/go/kingProject/config","/go/kingProject/log"]
# docker run命令触发的真实命令(相当于直接运行编译后的可运行文件)
ENTRYPOINT ["./main"]

over，Enjoy！！！

参考资料：
如何为你的Go应用创建轻量级Docker镜像？
两个奇技淫巧，将 Docker 镜像体积减小 99%
不要轻易使用 Alpine 镜像来构建 Docker 镜像，有坑！
Golang build笔记standard_init_linux.go:211: exec user process caused no such file or directory
容器化Go应用–基础镜像的未知时区问题

Scoful
关注
  • 2
    点赞
  • 踩
  • 5
    收藏
    觉得还不错? 一键收藏
  • 5
    评论
专栏目录
Docker的体系架构、Dockerfile讲解、分层原理
m0_56342013的博客
07-06 1298
Docker的体系架构、Dockerfile讲解、分层原理
极简（最小）JDK1.8 Docker镜像
09-22
极简（最小）JDK1.8 Docker镜像包，里面包含apk,wget,curl等命令
Docker部署Golang项目及镜像优化实战
Lyon_Nee的博客
03-24 560
Docker部署Golang项目及镜像优化实战 今天在部署公司的项目时, 了解到目标服务器有Docker环境,于是就想着基于Docker来部署项目 这篇文章记录了一次完整的构建镜像到优化的完整过程. 基础环境 Docker Windows10 (我的工作环境,其他平台操作一样) 编辑Dockerfile文件,构建docker镜像 基于简单,快速构建部署的原则,我选择在构建docker镜像时编译程序.即 上传项目源代码,通过Dockerfile命令声明完成编译,再运行二进制文件.先展示我的文件目
如何把Docker镜像分发速度提升90+%
02-25
现在，Docker技术正如狂风暴雨般改变着我们的基础设施架构。在腾讯，我们构建了大规模的容器云平台，其上运行了不同的应用，如广告推荐，消息推送等。其中也包括了像机器学习模型训练这类任务，这类任务包含很多的子任务（可能数百甚至上千个），当部署这种包含很多容器的任务时，会同时从DockerRegistry拉取（Pull）镜像，这种高并发的拉取操作，很容易耗尽DockerRegistry的网络资源，这时，DockerRegistry的网络出带宽就成了整个部署任务的瓶颈。一旦DockerRegistry变的不可用，整个容器平台的可用性也随之降低，甚至导致级联失效（CascadingFailure）。我
详解nodejs之创建最小docker镜像
09-30
主要介绍了详解nodejs之创建最小docker镜像,小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
构建Golang应用最小Docker镜像的实现
09-16
主要介绍了构建Golang应用最小Docker镜像的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
【Docker】Dockerfile构建最小镜像
m0_74315688的博客
01-14 2697
自定义镜像
如何搭建小体积的docker镜像
qq_44389898的博客
07-18 252
golang项目 docker dockerfile
超级小的docker镜像
迷失蒲公英
04-25 569
超级小的docker镜像，通过可用来做基础镜像或者测试使用。拉镜像尽量选择带有apline或slim标签的，体积很小。
docker 最小镜像（scratch：latest）与golang程序结合，从零构建后端镜像
向上的信念
08-24 2115
docker 最小镜像（scratch：latest） 一、简介： Scratch镜像很赞，它简洁、小巧而且快速，它没有bug、安全漏洞、延缓的代码或技术债务。除了被Docker添加了metadata (译注：元数据为描述数据的数据)之外，它基本上是空的。 我们在使用Dockerfile构建docker镜像时，一种方式是使用官方预先配置好的容器镜像。优点是我们不用从头开始构建，节省了很多工作量，但付出的代价是需要下载很大的镜像包。 如果我们的需求是在构建一个符合我们实际业务需求的Docker镜像的前提下，确
Docker构建最小镜像
最新发布
lightstar998的博客
04-11 135
使用此从一个空白的镜像源开始构建你的镜像，因此占用空间很小。它不会包含任何额外的操作系统或文件系统。
解决alpine构建容器镜像缓慢的问题
WOOOLILI
03-20 507
alpine使用国内镜像地址做软件源解决构建缓慢的问题。
go Jenkins流水线极速打包镜像上传
了迹奇有没
09-08 957
由于go本身打包机制良好，当依赖文件不多时，构建速度的优化可能并不明显，这时候我建议使用一体的Dockerfile直接构建，可以减少一些维护成本。在上述步骤中，第一步是打一个go的可执行文件，然后再构建一个linux环境。需要注意的是，以上的“go-1.18.6”是在Jenkins中进行安装时，起的名字，指向的是具体的插件，而不是这里填什么Jenkins下载什么。在上述构建中，最慢的步骤是go的打包，如果选择选用服务器安装go进行打包，再将打好的可执行文件直接构建成docker镜像，一定会快很多。
排查构建镜像时 IO 慢的问题
每天都要开心呀(#^.^#)
02-12 1732
docker build构建镜像常遇问题
builder docker构建最小 java 11 镜像
weixin_45288098的博客
05-10 920
基于alpine构建的精简java 11 docker镜像,官方的镜像没有做本地化操作针对技术选型:alpine linux系统仅4M使用 eclipse jdk 11 和 alpine linux系统解决:1.中文乱码2.镜像时区问题。
三个技巧，将Docker镜像体积减小90%
Richardlygo的博客
01-14 686
在构建 Docker 容器时，应该尽量想办法获得体积更小的镜像，因为传输和部署体积较小的镜像速度更快。 但RUN语句总是会创建一个新层，而且在生成镜像之前还需要使用很多中间文件，在这种情况下，该如何获得体积更小的镜像呢？ 你可能已经注意到了，大多数 Dockerfiles 都使用了一些奇怪的技巧： FROM ubuntu RUN apt-get update &amp...
docker java 最小镜像_Docker容器之最小JDK基础镜像
weixin_28829173的博客
02-26 313
一、说明1、使用的是Oracle的JRE不是openjdk。alpine小道消息据说docker要换成这个作为基础镜像2、因为java依赖glibc，所以基础镜像使用的是alpine-glibc而非alpine，alpine-glibc大概是11.1M。二、制作1、首先下载jre，下载地址是https://www.java.com/en/download/manual.jsp，大概是77M。2、解...
如何将 Docker 镜像大小从 1.43 GB 减少到 22.4 MB
05-15 2139
如果你正在从事 Web 开发，那么你可能已经了解过容器化的概念以及它的优点。 但是，当使用 Docker 时，镜像大小是一个很大的问题。仅仅是从 create-react-app 中得到的样板项目就通常超过 1.43 GB。 今天我们将会容器化一个 ReactJS 应用程序，并学习一些关于如何减小镜像大小以及同时提高性能的技巧。
【docker】docker建立最简单最小的helloworld镜像
热门推荐
图像、视频、算法、Linux
04-19 1万+
本篇博客旨在手动制作一个最简单的myhello镜像，而并非使用用官方的hello-world。 首先运行一下官方的hello-world看看效果： $ docker run hello-world Hello from Docker! This message shows that your installation appears to be working correctly. T...
go项目制作成docker镜像
08-09
要将go项目制作成docker镜像，你可以按照以下步骤进行操作： 1. 在你的go项目目录下创建一个名为Dockerfile的文件。你可以参考引用中提供的示例文件内容。 2. 在Dockerfile中，使用FROM指令指定基础镜像，例如alpine。你可以参考引用中的示例。 3. 使用COPY指令将go项目中的可执行文件复制到容器中的指定路径，例如/app/main。 4. 使用CMD指令设置容器启动时要执行的命令，例如["/app/main"]。 5. 保存Dockerfile并在终端中使用docker build命令来构建镜像。例如，运行"docker build -t go ."。 6. 等待构建完成后，你的go项目就以名为go的镜像成功制作出来了。 请注意，以上步骤仅为制作go项目的docker镜像的基本过程，实际操作可能根据你的项目结构和需求有所不同。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 5
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值