如何使用Docker镜像构建Go应用

魁首哥

作者

如何使用Docker镜像构建Go应用

这篇文章主要介绍了如何使用Docker镜像构建Go应用的相关知识，内容详细易懂，操作简单快捷，具有一定借鉴价值，相信大家阅读完这篇如何使用Docker镜像构建Go应用文章都会有所收获，下面我们一起来看看吧。

修炼背景

我夜以继日，加班加点开发了一个最简单的 Go Hello world 应用，虽然只是跑了打印一下就退出了，但是老板也要求我上线这个我能写出的唯一应用。

项目结构如下：

.├──go.mod└──hello.go

hello.go 代码如下：

packagemainfuncmain(){println("helloworld!")}

并且，老板要求用 docker 部署，显得咱们紧跟潮流，高大上一点。。。

第一次尝试

我在拜访了一些武林朋友之后，发现把整个过程丢到 docker 里面去编译一下就好了，一番琢磨之后，我得到了如下 Dockerfile:

FROMgolang:alpineWORKDIR/buildCOPYhello.go.RUNgobuild-ohellohello.goCMD["./hello"]

构建镜像：

$dockerbuild-thello:v1.

搞定，让我们凑近了看看。

$dockerrun-it--rmhello:v1ls-l/buildtotal1260-rwxr-xr-x1rootroot1281547Mar615:54hello-rw-r--r--1rootroot55Mar614:59hello.go

好家伙，我好不容易写出来的代码也在里面，看来代码不能写的烂，不然运维妹子偷看了要笑话我。。。

我们再看看镜像到底有多大，据说大了拉取镜像就会比较慢呢

$dockerimages|grephellohellov12783ee22101444minutesago314MB

哇，居然有314MB，难道 docker build 一下变 Java 了吗？不是什么东西都是越大越好的。。。

让我们看看为啥这么大！

看看，我们跑第一个指令（WORKDIR）前就已经300+MB了，有点猛啊！

不管怎么说，我们先跑一下看看

$dockerrun-it--rmhello:v1helloworld!

没问题呀，好歹可以工作嘛～

第二次尝试

经过一番烟酒，加上朋友指点，发现原来我们用的那个基础镜像实在太大了。

$dockerimages|grepgolanggolangalpined026981a71652daysago313MB

并且朋友告诉我可以把代码先编译好，再拷贝进去，就不用那个巨大的基础镜像了，不过说起来容易，我还是好好花了点功夫的，最后 Dockerfile 长这样：

FROMalpineWORKDIR/buildCOPYhello.CMD["./hello"]

跑一下试试

$dockerbuild-thello:v2....=>ERROR[3/3]COPYhello.0.0s------>[3/3]COPYhello.:------failedtocomputecachekey:"/hello"notfound:notfound

不对，hello 找不到，忘记先编译一下 hello.go 了，再来~

$gobuild-ohellohello.go

再跑 docker build -t hello:v2 .，没问题，走两步试试。。。

$dockerrun-it--rmhello:v2standard_init_linux.go:228:execuserprocesscaused:execformaterror

失败！好吧，格式不对，原来我们开发机不是 linux 呀，再来~

$GOOS=linuxgobuild-ohellohello.go

重新 docker build 终于搞定了，赶紧跑下

$dockerrun-it--rmhello:v2helloworld!

没问题，我们来看看内容和大小。

$dockerrun-it--rmhello:v2ls-l/buildtotal1252-rwxr-xr-x1rootroot1281587Mar616:18hello

里面只有 hello 这个可执行文件，再也不用担心别人鄙视我的代码了~

$dockerimages|grephellohellov20dd53f016c9353secondsago6.61MBhellov1ac0e37173b8525minutesago314MB

哇，6.61MB，绝对可以！

看看，我们跑第一个指令（WORKDIR）前面只有 5.3MB 了，开心啊！

第三次尝试

一顿炫耀之后，居然有人鄙视我，说现在流行什么多阶段构建，那么第二种方式到底有啥问题呢？细细琢磨之后发现，我们要能从 Go 代码构建出 docker 镜像，其中分为三步：

本机编译 Go 代码，如果牵涉到 cgo 跨平台编译就会比较麻烦了
用编译出的可执行文件构建 docker 镜像
编写 shell 脚本或者 makefile 让这几步通过一个命令可以获得

多阶段构建就是把这一切都放到一个 Dockerfile 里，既没有源码泄漏，又不需要用脚本去跨平台编译，还获得了最小的镜像。

爱学习，追求完美的我最终写出了如下 Dockerfile，多一行则肥，少一行则瘦：

FROMgolang:alpineASbuilderWORKDIR/buildADDgo.mod.COPY..RUNgobuild-ohellohello.goFROMalpineWORKDIR/buildCOPY--from=builder/build/hello/build/helloCMD["./hello"]

第一个 FROM 开始的部分是构建一个 builder 镜像，目的是在其中编译出可执行文件 hello，第二个 From 开始的部分是从第一个镜像里 copy 出来可执行文件 hello，并且用尽可能小的基础镜像 alpine 以保障最终镜像尽可能小，至于为啥不用更小的 scratch，是因为 scratch 真的啥也没有，有问题连上去看一眼的机会都没有，而 alpine 也才 5MB，对我们的服务不会构成多少影响。

我们先跑了验证一下：

$dockerrun-it--rmhello:v3helloworld!

没问题，正如预期！看看大小如何：

$dockerimages|grephellohellov3f51e1116be118hoursago6.61MBhellov20dd53f016c938hoursago6.61MBhellov1ac0e37173b858hoursago314MB

跟第二种方法构建的镜像大小完全一样。再看看镜像里的内容：

$dockerrun-it--rmhello:v3ls-l/buildtotal1252-rwxr-xr-x1rootroot1281547Mar616:32hello

也是只有一个可执行的 hello 文件，完美！

跟第二个最终镜像基本是一致的，但我们简化了流程，只需要一个 Dockerfile，跑一条命令就好了，不需要我去整那些晦涩难懂的 shell 和 makefile 了。

神功练成

至此，团队小伙伴都觉得完美，纷纷给我点赞！但是，既追求完美，又喜欢偷懒（摸鱼）的我觉得吧，每次都让我写出这么个增一行则肥，减一行则瘦的 Dockerfile，我还是觉得挺烦的，于是我瞒着老板写了个工具，我来秀一秀~~

#安装一下先$GOPROXY=https://goproxy.cn/,directgoinstallgithub.com/zeromicro/go-zero/tools/goctl@latest#一键编写Dockerfile$goctldocker-gohello.go

搞定！看看生成的 Dockerfile 哈

FROMgolang:alpineASbuilderLABELstage=gobuilderENVCGO_ENABLED0ENVGOOSlinuxENVGOPROXYhttps://goproxy.cn,directWORKDIR/buildADDgo.mod.ADDgo.sum.RUNgomoddownloadCOPY..RUNgobuild-ldflags="-s-w"-o/app/hello./hello.goFROMalpineRUNapkupdate--no-cache&&apkadd--no-cacheca-certificatestzdataENVTZAsia/ShanghaiWORKDIR/appCOPY--from=builder/app/hello/app/helloCMD["./hello"]

其中几点可以了解下：

默认禁用了 cgo
启用了 GOPROXY
去掉了调试信息 -ldflags="-s -w" 以减小镜像尺寸
安装了 ca-certificates，这样使用 TLS证书就没问题了
自动设置了本地时区，这样我们在日志里看到的是北京时间了

我们看看用这个自动生成的 Dockerfile 构建出的镜像大小：

$dockerimages|grephellohellov4a7c3baed27064secondsago7.97MBhellov3f51e1116be118hoursago6.61MBhellov20dd53f016c938hoursago6.61MBhellov1ac0e37173b859hoursago314MB

略微大一点，这是因为我们安装了 ca-certificates 和 tzdata。验证一下：