在 Go 語言項目中使用 Docker

原文連接：在 Go 語言項目中使用 Docker

容器（Container） 將程序及其所需的任何內容捆綁在一塊兒，包括依賴項、工具和配置文件等等。這樣使得程序不受環境的干擾，真正意義上作到開發環境和生成環境徹底一致。

而 Docker 在容器的基礎上，進行了進一步的封裝，從文件系統、網絡互聯到進程隔離等等，極大的簡化了容器的建立和維護。與傳統虛擬機相比，Docker 也有許多優勢，如：更高效的系統資源利用和更快速的啓動時間。

在本文中，經過一個簡單的 Go 語言項目，您將學習如何在 Go 語言項目中使用 Docker。

建立一個簡單的 Go 語言項目

讓咱們來建立一個做爲示例的 Go 語言項目。在命令行下輸入如下命令以建立文件夾：

mkdir gdp

咱們將使用 Go Module 進行依賴性管理。轉到項目的根目錄，而後初始化 Go Module：

cd gdp
go mod init github.com/linehk/gdp

咱們將建立一個簡單的 hello 服務器。在項目根目錄中建立一個名爲 hello_server.go 的新文件：

touch hello_server.go

文件內容以下：

package main

import (
    "fmt"
    "log"
    "net/http"
    "time"

    "github.com/gorilla/mux"
)

func handler(w http.ResponseWriter, r *http.Request) {
    query := r.URL.Query()
    name := query.Get("name")
    if name == "" {
        name = "Guest"
    }
    log.Printf("Received request for %s.\n", name)
    w.Write([]byte(fmt.Sprintf("Hello, %s!\n", name)))
}

func main() {
    r := mux.NewRouter()
    r.HandleFunc("/", handler)
    server := &http.Server{
        Handler:      r,
        Addr:         ":8080",
        ReadTimeout:  10 * time.Second,
        WriteTimeout: 10 * time.Second,
    }
    log.Println("Starting Server.")
    if err := server.ListenAndServe(); err != nil {
        log.Fatal(err)
    }
}

該項目使用 gorilla/mux 包來建立 HTTP 路由（導入包是爲了展現 Docker 容器捆綁依賴項的做用），地址是 localhost:8080。

嘗試在本地編譯並運行項目

讓咱們先嚐試在本地編譯和運行項目。能夠在項目根目錄輸入如下命令來編譯項目：

go build

go build 命令將會生成一個名爲 gdp 的可執行文件。能夠像這樣運行該文件：

./gdp
2020/08/19 21:33:49 Starting Server.

咱們的 hello 服務器如今正在運行，能夠嘗試使用 curl 或其它工具與其交互：

curl http://localhost:8080
Hello, Guest!

curl http://localhost:8080?name=sulinehk
Hello, sulinehk!

編寫 Dockerfile 定義 Docker 鏡像

讓咱們來爲這個項目編寫 Dockerfile，在根目錄建立文件名爲 Dockerfile 的文件，內容以下：

# 拉取 Go 語言最新的基礎鏡像
FROM golang:latest

# 在容器內設置 /app 爲當前工做目錄
WORKDIR /app

# 把文件複製到當前工做目錄
COPY . .

# 設置 GOPROXY 環境變量
ENV GOPROXY="https://goproxy.cn"

# 下載所有依賴項
RUN go mod download

# 編譯項目
RUN go build -o gdp .

# 暴露 8080 端口
EXPOSE 8080

# 執行可執行文件
CMD ["./gdp"]

構建鏡像和運行容器

鏡像（Image） 是實際的軟件分發包，其中包含運行應用程序所需的全部內容。

而容器根據鏡像構建，是鏡像的運行示例，相似 Go 語言中結構體定義和結構體變量之間的關係。

• 構建鏡像：

docker build -t gdp .

• 運行容器：

docker run -d -p 8080:8080 gdp
aa6a1afbe1b13ad0b0d1d656e157f762c5fe2229a8e0d95a025df26396ffc08f

• 與容器內運行的服務器交互：

curl http://localhost:8080
Hello, Guest!

curl http://localhost:8080?name=sulinehk
Hello, sulinehk!

下面是一些其它的 Docker 命令：

總結

能夠看出，一個定義良好的 Dockfile 文件在整個流程中起到承上啓下的做用。

參考連接

Docker — 從入門到實踐

Docker Documentation