在 Go 語言項目中使用 Docker

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

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

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

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

Golang and Docker logo

建立一個簡單的 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 命令：

Docker 命令

總結

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

Dockerfile

參考連接

Docker — 從入門到實踐

Docker Documentation