在编译二进制程序时，动态赋值程序的某些值，使程序包含了可靠的编译信息。
Go 二进制中包含编译信息
- 如果服务上线后，不知道此二进制文件是哪个版本产出的二进制，那么本文可以帮助你实现相关的功能。
- 在二进制代码发布时，传入必要的版本信息，以便日后可查看相关信息。
- 可用于 git-runner 中，直接获取版本信息、分支信息等，填充相应参数。
效果展示
binary 是我们例子中的二进制文件
1
2
3
4
5
6
| # ./main -v
Commit ID : 123
Build Name: version test
Build Time: 20190620
Build Vers: 1.1
Golang Vers: go version go1.10.3 linux/amd64
|
实现方法
- 在golang 解析参数部分添加如下内容:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
| package main
import "github.com/lpflpf/version"
import "flag"
func main() {
var showVer bool
// 为了举例，所以仅使用了-v 选项
flag.BoolVar(&showVer, "v", false, "show build version")
flag.Parse()
if showVer {
version.Show()
}
}
|
version 包如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
| package version
import (
"fmt"
"os"
)
// 连接过程中修改如下5个参数，可以自行添加使用
var (
BuildVersion string
BuildTime string
BuildName string
CommitID string
GoVersion string
)
func Show() {
fmt.Printf("Commit ID : %s\n", CommitID)
fmt.Printf("Build Name: %s\n", BuildName)
fmt.Printf("Build Time: %s\n", BuildTime)
fmt.Printf("Build Vers: %s\n", BuildVersion)
fmt.Printf("Golang Vers: %s\n", GoVersion)
os.Exit(0)
}
|
- 编译程序，编译脚本如下：
1
2
3
4
5
6
7
8
9
10
11
12
| BUILD_TIME=`date +%Y%m%d`
BUILD_VERSION=1.1
COMMIT_ID=123
GO_VERSION=`go version`
BUILD_NAME="version test"
VERSION_PKG='github.com/lpflpf/version'
LD_FLAGS="-s -w -X '$VERSION_PKG.BuildTime=$BUILD_TIME' \
-X '$VERSION_PKG.BuildVersion=$BUILD_VERSION' \
-X '$VERSION_PKG.BuildName=$BUILD_NAME' \
-X '$VERSION_PKG.CommitID=$COMMIT_ID' \
-X '$VERSION_PKG.GoVersion=$GO_VERSION'"
go build -ldflags "$LD_FLAGS" main.go
|
- 执行脚本， 则看到本文开头说明的二进制版本信息
原理分析
在golang 进行连接包时，允许将字符串传入包的变量中。因此，在编译时，通过ld选项添加相应变量，实现了二进制中保存编译信息的功能。
参考文档
- golang 连接说明
- version 包
