構建 Go 應用 docker 鏡像的十八種姿勢
作者:kevinwan
來源:SegmentFault 思否社區(qū)
修煉背景
我夜以繼日,加班加點開發(fā)了一個最簡單的 Go Hello world 應用,雖然只是跑了打印一下就退出了,但是老板也要求我上線這個我能寫出的唯一應用。
項目結構如下:
.
├── go.mod
└── hello.go
hello.go 代碼如下:
package main
func main() {
println("hello world!")
}
并且,老板要求用 docker 部署,顯得咱們緊跟潮流,高大上一點。。。
第一次嘗試
我在拜訪了一些武林朋友之后,發(fā)現把整個過程丟到 docker 里面去編譯一下就好了,一番琢磨之后,我得到了如下 Dockerfile:
FROM golang:alpine
WORKDIR /build
COPY hello.go .
RUN go build -o hello hello.go
CMD ["./hello"]
構建鏡像:
$ docker build -t hello:v1 .
搞定,讓我們湊近了看看。
$ docker run -it --rm hello:v1 ls -l /build
total 1260
-rwxr-xr-x 1 root root 1281547 Mar 6 15:54 hello
-rw-r--r-- 1 root root 55 Mar 6 14:59 hello.go
好家伙,我好不容易寫出來的代碼也在里面,看來代碼不能寫的爛,不然運維妹子偷看了要笑話我。。。
我們再看看鏡像到底有多大,據說大了拉取鏡像就會比較慢呢
$ docker images | grep hello
hello v1 2783ee221014 44 minutes ago 314MB
哇,居然有314MB,難道 docker build 一下變 Java 了嗎?不是什么東西都是越大越好的。。。
讓我們看看為啥這么大!

看看,我們跑第一個指令(WORKDIR)前就已經300+MB了,有點猛??!
不管怎么說,我們先跑一下看看
$ docker run -it --rm hello:v1
hello world!
沒問題呀,好歹可以工作嘛~
第二次嘗試
經過一番煙酒,加上朋友指點,發(fā)現原來我們用的那個基礎鏡像實在太大了。
$ docker images | grep golang
golang alpine d026981a7165 2 days ago 313MB
并且朋友告訴我可以把代碼先編譯好,再拷貝進去,就不用那個巨大的基礎鏡像了,不過說起來榮譽,我還是花了點功夫,最后 Dockerfile 長這樣
FROM alpine
WORKDIR /build
COPY hello .
CMD ["./hello"]
跑一下試試
$ docker build -t hello:v2 .
...
=> ERROR [3/3] COPY hello . 0.0s
------
> [3/3] COPY hello .:
------
failed to compute cache key: "/hello" not found: not found
不對,hello 找不到,忘記先編譯一下 hello.go 了,再來~
$ go build -o hello hello.go
再跑 docker build -t hello:v2 .,沒問題,走兩步試試。。。
$ docker run -it --rm hello:v2
standard_init_linux.go:228: exec user process caused: exec format error
失敗!好吧,格式不對,原來我們開發(fā)機不是 linux 呀,再來~
$ GOOS=linux go build -o hello hello.go
重新 docker build 終于搞定了,趕緊跑下
$ docker run -it --rm hello:v2
hello world!
沒問題,我們來看看內容和大小。
$ docker run -it --rm hello:v2 ls -l /build
total 1252
-rwxr-xr-x 1 root root 1281587 Mar 6 16:18 hello
里面只有 hello 這個可執(zhí)行文件,再也不用擔心別人鄙視我的代碼了~
$ docker images | grep hello
hello v2 0dd53f016c93 53 seconds ago 6.61MB
hello v1 ac0e37173b85 25 minutes ago 314MB
哇,6.61MB,絕對可以!

看看,我們跑第一個指令(WORKDIR)前面只有 5.3MB 了,開心??!
第三次嘗試
一頓炫耀之后,居然有人鄙視我,說現在流行什么多階段構建,那么第二種方式到底有啥問題呢?細細琢磨之后發(fā)現,我們要能從 Go 代碼構建出 docker 鏡像,其中分為三步:
本機編譯 Go 代碼,如果牽涉到 cgo 跨平臺編譯就會比較麻煩了 用編譯出的可執(zhí)行文件構建 docker 鏡像 編寫 shell 腳本或者 makefile 讓這幾步通過一個命令可以獲得
FROM golang:alpine AS builder
WORKDIR /build
ADD go.mod .
COPY . .
RUN go build -o hello hello.go
FROM alpine
WORKDIR /build
COPY --from=builder /build/hello /build/hello
CMD ["./hello"]
$ docker run -it --rm hello:v3
hello world!
$ docker images | grep hello
hello v3 f51e1116be11 8 hours ago 6.61MB
hello v2 0dd53f016c93 8 hours ago 6.61MB
hello v1 ac0e37173b85 8 hours ago 314MB
$ docker run -it --rm hello:v3 ls -l /build
total 1252
-rwxr-xr-x 1 root root 1281547 Mar 6 16:32 hello

神功練成
# 安裝一下先
$ GOPROXY=https://goproxy.cn/,direct go install github.com/zeromicro/go-zero/tools/goctl@latest
# 一鍵編寫 Dockerfile
$ goctl docker -go hello.go
FROM golang:alpine AS builder
LABEL stage=gobuilder
ENV CGO_ENABLED 0
ENV GOPROXY https://goproxy.cn,direct
RUN apk update --no-cache && apk add --no-cache tzdata
WORKDIR /build
ADD go.mod .
ADD go.sum .
RUN go mod download
COPY . .
RUN go build -ldflags="-s -w" -o /app/hello ./hello.go
FROM alpine
RUN apk update --no-cache && apk add --no-cache ca-certificates
COPY --from=builder /usr/share/zoneinfo/Asia/Shanghai /usr/share/zoneinfo/Asia/Shanghai
ENV TZ Asia/Shanghai
WORKDIR /app
COPY --from=builder /app/hello /app/hello
CMD ["./hello"]
默認禁用了 cgo 啟用了 GOPROXY 加速 go mod download 去掉了調試信息 -ldflags="-s -w" 以減小鏡像尺寸 安裝了 ca-certificates,這樣使用 TLS證書就沒問題了 tzdata 在 builder 鏡像安裝,并在最終鏡像只拷貝了需要的時區(qū) 自動設置了本地時區(qū),這樣我們在日志里看到的是北京時間了
$ docker images | grep hello
hello v4 94ba3ece3071 4 hours ago 6.66MB
hello v3 f51e1116be11 8 hours ago 6.61MB
hello v2 0dd53f016c93 8 hours ago 6.61MB
hello v1 ac0e37173b85 9 hours ago 314MB

$ docker run -it --rm hello:v4 ls -l /app
total 832
-rwxr-xr-x 1 root root 851968 Mar 7 08:36 hello
$ docker run -it --rm hello:v4
hello world!
$ goctl docker -base scratch -go hello.go
$ docker images | grep hello
hello v5 d084eed88d88 4 seconds ago 1.07MB
hello v4 94ba3ece3071 15 hours ago 6.66MB
hello v3 f51e1116be11 4 days ago 6.61MB
hello v2 0dd53f016c93 4 days ago 6.61MB
hello v1 ac0e37173b85 4 days ago 314MB

$ docker build --rm --platform linux/amd64 -t hello:v6 .
項目地址:https://github.com/zeromicro/go-zero

