為Go程式建立最小的Docker Image

這是一個建立於 的文章，其中的資訊可能已經有所發展或是發生改變。

本文將會介紹如何使用docker打包一個golang編寫的應用程式，最終的產物就是一個Dockerfile檔案，可別小瞧這短短几行代碼，涉及的知識點可不少，接下來我們就仔細剖析一下吧。

FROM golang:alpineADD src /go/srcRUN go install -v test ENTRYPOINT ["/go/bin/test"]CMD ["-logtostderr"]

1. 基礎鏡像選擇

第一行是指定一個基礎鏡像，在此基礎上建立我們的鏡像，此處使用的是golang：alpine版本，
這是一個相對較小的linux系統，砍掉了linux中的許多工具，包管理工具使用的是apk，可以把這個鏡像docker pull下來把玩一番，預設的shell是sh，執行命令docker run -t-i golang:alpine /bin/sh 進入命令列。進入後執行env查看環境變數，因為其GOPATH這個環境變數對後面的環境部署有用，可以看到環境變數GOPATH預設值為/go

2. 映射代碼檔案並安裝

使用 ADD src /go/src 將主機scr檔案對應到/go/src目錄下,為什麼非得是這個/go/src這個目錄呐？沒錯就是上面的GOPATH環境變數的路徑，因為我們後面需要執行go install命令進行安裝，否則的話就需要重新設定GOPATH才能安裝編譯後的二進位檔案。
需要注意的是此時本地主機中src目錄中檔案的組織，要執行go install就要嚴格遵循產生包的檔案結構，test是程式的主程式，glog是使用的開源日誌庫，整個檔案結構如下，因為在main.go匯入包的時候使用的是"github.com/golang/glog"這個路徑，所以需要給其一個合理的路徑。

.├── Dockerfile└── src    ├── github.com    │   └── golang    │       └── glog    │           ├── glog_file.go    │           ├── glog.go    │           ├── glog_test.go    │           ├── LICENSE    │           └── README    └── test        └── main.go

還有一個小tips是程式的日誌庫使用的是第三方開源的glog，當我們使用git對我們上述代碼進行版本管理的時候就不需要重複包含glog的代碼，直接添加一個對其的引用就可以，這樣有很多好處，當庫中代碼被修改後可以直接更新到遠端代碼倉庫中，在clone的時候可以自動匯入該庫，也就是說在本地會拉取具體的代碼，但是在遠程倉庫只是儲存引用。
可以通過命令產生glog這個子模組： git submodule add https://github.com/golang/glog.git src/github.com/golang/glog。注意git remoule命令中被引用到的位置為src/github.com/golang而不是直接的src/ 中，因為執行該命令後本地代碼倉庫會clone glog這個代碼倉庫，將它的代碼拉下來，只是建立glog這個目錄，所以前面的一些父目錄需要自己建立。關於命令更多的介紹參見 Git。
組織好檔案結構就可以進行go install了，產生的可執行在$GOPATH/bin中，後面就是基本的指定入口程式和參數。通過docker build -t="name" . 產生鏡像

3.更進一步：提前編譯

上面的方式是將代碼拷貝進基礎鏡像並在其內部編譯，毫無疑問的是golang：alpine中包含一系列程式啟動並執行依賴，程式運行會動態載入這些庫，我們可以用ldd命令查看所產生的二進位檔案的依賴：

linux-vdso.so.1 =>  (0x00007ffc5b1e4000)libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007f50a1f13000)libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f50a1b4a000)/lib64/ld-linux-x86-64.so.2 (0x00005611a4b0a000)

那麼問題來了？ 如果將這些依賴靜態編譯至可執行檔中那就不需要在環境中儲存這些多餘的資訊了，就可以建立一個更小的鏡像了。幸運的是無論是golang的編譯機制還是docker的基礎鏡像都提供這樣的實現：
使用命令產生靜態編譯的二進位檔案：CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .
此時用ldd查看產生的可執行檔的依賴，可以看到顯示not a dynamic executable，這裡我們禁用CGO使其產生靜態二進位檔案，同時設定系統為linux。我們將基礎鏡像設定為 scratch，這是一個很小的的鏡像。
重新編寫的Dockerfile如下：

FROM scratchADD main /ENTRYPOINT ["/main"]CMD ["-logtostderr"]

執行docker build -t example-scratch .產生鏡像，可以看到該鏡像的大小隻有8.27M大小，並且可以正常執行。
在實際情況中有時會將兩種情況結合使用，先在一個鏡像中構建，在另一個鏡像中執行。下面的Dockerfile摘自prometheus這個第三方監控的示範案例的Dockerfile,可以看到它是首先在builder鏡像中下載對應的依賴並且編譯器，最後在scratch基礎鏡像中執行程式。

# This Dockerfile builds an image for a client_golang example.## Use as (from the root for the client_golang repository):jingx#    docker build -f examples/$name/Dockerfile -t prometheus/golang-example-$name .# Builder image, where we build the example.FROM golang:1.9.0 AS builderWORKDIR /go/src/github.com/prometheus/client_golangCOPY . .WORKDIR /go/src/github.com/prometheus/client_golang/prometheusRUN go get -dWORKDIR /go/src/github.com/prometheus/client_golang/examples/simpleRUN CGO_ENABLED=0 GOOS=linux go build -a -tags netgo -ldflags '-w'# Final image.FROM scratchLABEL maintainer "The Prometheus Authors <prometheus-developers@googlegroups.com>"COPY --from=builder /go/src/github.com/prometheus/client_golang/examples/simple .EXPOSE 8080ENTRYPOINT ["/simple"]

參考

Building Minimal Docker Containers for Go Applications