如何用 GVM 管理 Go 專案

2019-10-11 11:22:00

使用 Go 版本管理器管理多個版本的 Go 語言環境及其模組。

Go 語言版本管理器(GVM)是管理 Go 語言環境的開源工具。GVM “pkgsets” 支援安裝多個版本的 Go 並管理每個專案的模組。它最初由 Josh Bussdieker 開發,GVM(像它的對手 Ruby RVM 一樣)允許你為每個專案或一組專案建立一個開發環境,分離不同的 Go 版本和包依賴關係,以提供更大的靈活性,防止不同版本造成的問題。

有幾種管理 Go 包的方式,包括內建於 Go 中的 Go 1.11 的 Modules。我發現 GVM 簡單直觀,即使我不用它來管理包,我還是會用它來管理 Go 不同的版本的。

安裝 GVM

安裝 GVM 很簡單。GVM 儲存庫安裝文件指示你下載安裝程式指令碼並將其傳送到 Bash 來安裝:

bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)

儘管越來越多的人採用這種安裝方法,但是在安裝之前先看看安裝程式在做什麼仍然是一個很好的想法。以 GVM 為例,該安裝程式指令碼:

  1. 檢查一些相關依賴性
  2. 克隆 GVM 儲存庫
  3. 使用 shell 指令碼:
    • 安裝 Go 語言
    • 管理 GOPATH 環境變數
    • bashrczshrc 或組態檔中新增一行內容

如果你想確認它在做什麼,你可以克隆該儲存庫並檢視 shell 指令碼,然後執行 ./binscripts/gvm-installer 這個本地指令碼進行設定。

注意: 因為 GVM 可以用來下載和編譯新的 Go 版本,所以有一些預期的依賴關係,如 Make、Git 和 Curl。你可以在 GVM 的讀我檔案中找到完整的發行版列表。

使用 GVM 安裝和管理 GO 版本

一旦安裝了 GVM,你就可以使用它來安裝和管理不同版本的 Go。gvm listall 命令顯示可下載和編譯的可用版本的 Go:

[chris@marvin ]$ gvm listallgvm gos (available)   go1   go1.0.1   go1.0.2   go1.0.3<輸出截斷>

安裝特定的 Go 版本就像 gvm install <版本> 一樣簡單,其中 <版本>gvm listall 命令返回的版本之一。

假設你正在進行一個使用 Go1.12.8 版本的專案。你可以使用 gvm install go1.12.8 安裝這個版本:

[chris@marvin]$ gvm install go1.12.8Installing go1.12.8... * Compiling...go1.12.8 successfully installed!

輸入 gvm list,你會看到 Go 版本 1.12.8 與系統 Go 版本(使用作業系統的軟體包管理器打包的版本)一起並存:

[chris@marvin]$ gvm listgvm gos (installed)   go1.12.8=> system

GVM 仍在使用系統版本的 Go ,由 => 符號表示。你可以使用 gvm use 命令切換你的環境以使用新安裝的 go1.12.8:

[chris@marvin]$ gvm use go1.12.8Now using version go1.12.8[chris@marvin]$ go versiongo version go1.12.8 linux/amd64

GVM 使管理已安裝版本的 Go 變得極其簡單,但它不止於此!

使用 GVM pkgset

開箱即用,Go 有一種出色而令人沮喪的管理包和模組的方式。預設情況下,如果你 go get 獲取一個包,它將被下載到 $GOPATH 目錄中的 srcpkg 目錄下,然後可以使用 import 將其包含在你的 Go 程式中。這使得獲得軟體包變得很容易,特別是對於非特權使用者,而不需要 sudo 或 root 特權(很像 Python 中的 pip install --user)。然而,在不同的專案中管理相同包的不同版本是非常困難的。

有許多方法可以嘗試修復或緩解這個問題,包括實驗性 Go Modules(Go 1.11 版中增加了初步支援)和 Go dep(Go Modules 的“官方實驗”並且持續疊代)。在我發現 GVM 之前,我會在一個 Go 專案自己的 Docker 容器中構建和測試它,以確保分離。

GVM 通過使用 “pkgsets” 將專案的新目錄附加到安裝的 Go 版本的預設 $GOPATH 上,很好地實現了專案之間包的管理和隔離,就像 $PATH 在 Unix/Linux 系統上工作一樣。

想象它如何執行的。首先,安裝新版 Go 1.12.9:

[chris@marvin]$ echo $GOPATH/home/chris/.gvm/pkgsets/go1.12.8/global[chris@marvin]$ gvm install go1.12.9Installing go1.12.9... * Compiling...go1.12.9 successfully installed[chris@marvin]$ gvm use go1.12.9Now using version go1.12.9

當 GVM 被告知使用新版本時,它會更改為新的 $GOPATH,預設 gloabl pkgset 應用於該版本:

[chris@marvin]$ echo $GOPATH/home/chris/.gvm/pkgsets/go1.12.9/global[chris@marvin]$ gvm pkgset listgvm go package sets (go1.12.9)=>  global

儘管預設情況下沒有安裝額外的包,但是全域性 pkgset 中的包對於使用該特定版本的 Go 的任何專案都是可用的。

現在,假設你正在啟用一個新專案,它需要一個特定的包。首先,使用 GVM 建立一個新的 pkgset,名為 introToGvm:

[chris@marvin]$ gvm pkgset create introToGvm[chris@marvin]$ gvm pkgset use introToGvmNow using version go1.12.9@introToGvm[chris@marvin]$ gvm pkgset listgvm go package sets (go1.12.9)    global=>  introToGvm

如上所述,pkgset 的一個新目錄被新增到 $GOPATH

[chris@marvin]$ echo $GOPATH/home/chris/.gvm/pkgsets/go1.12.9/introToGvm:/home/chris/.gvm/pkgsets/go1.12.9/global

將目錄更改為預先設定的 introToGvm 路徑,檢查目錄結構,這裡使用 awkbash 完成。

[chris@marvin]$ cd $( awk -F':' '{print $1}' <<< $GOPATH )[chris@marvin]$ pwd/home/chris/.gvm/pkgsets/go1.12.9/introToGvm[chris@marvin]$ lsoverlay  pkg  src

請注意,新目錄看起來很像普通的 $GOPATH。新的 Go 包使用同樣的 go get 命令下載並正常使用,且新增到 pkgset 中。

例如,使用以下命令獲取 gorilla/mux 包,然後檢查 pkgset 的目錄結構:

[chris@marvin]$ go get github.com/gorilla/mux[chris@marvin]$ tree[chris@marvin introToGvm ]$ tree.├── overlay│   ├── bin│   └── lib│       └── pkgconfig├── pkg│   └── linux_amd64│       └── github.com│           └── gorilla│               └── mux.asrc/└── github.com    └── gorilla        └── mux            ├── AUTHORS            ├── bench_test.go            ├── context.go            ├── context_test.go            ├── doc.go            ├── example_authentication_middleware_test.go            ├── example_cors_method_middleware_test.go            ├── example_route_test.go            ├── go.mod            ├── LICENSE            ├── middleware.go            ├── middleware_test.go            ├── mux.go            ├── mux_test.go            ├── old_test.go            ├── README.md            ├── regexp.go            ├── route.go            └── test_helpers.go

如你所見,gorilla/mux 已按預期新增到 pkgset $GOPATH 目錄中,現在可用於使用此 pkgset 專案了。

GVM 讓 Go 管理變得輕而易舉

GVM 是一種直觀且非侵入性的管理 Go 版本和包的方式。它可以單獨使用,也可以與其他 Go 模組管理技術結合使用並利用 GVM Go 版本管理功能。按 Go 版本和包依賴來分離專案使得開發更加容易,並且減少了管理版本衝突的複雜性,GVM 讓這變得輕而易舉。