12使用 Go 管理版本

作者: 刷漆猫咪 | 来源:发表于2019-11-05 08:35 被阅读0次

简介

如果你曾经运行过 docker version,
就会发现它提供了很多信息:

PS C:\Users\tzh> docker version
Client: Docker Engine - Community
 Version:           19.03.4
 API version:       1.40
 Go version:        go1.12.10
 Git commit:        9013bf5
 Built:             Thu Oct 17 23:44:48 2019
 OS/Arch:           windows/amd64
 Experimental:      false

Server: Docker Engine - Community
 Engine:
  Version:          19.03.4
  API version:      1.40 (minimum version 1.12)
  Go version:       go1.12.10
  Git commit:       9013bf5
  Built:            Thu Oct 17 23:50:38 2019
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          v1.2.10
  GitCommit:        b34a5c8af56e510852c35414db4c1f4fa6172339
 runc:
  Version:          1.0.0-rc8+dev
  GitCommit:        3e425f80a8c931f88e6d94a8c831b9d5aa481657
 docker-init:
  Version:          0.18.0
  GitCommit:        fec3683

对于编译好的二进制文件而言, 获取版本信息是非常重要的.
尽可能地提供详细信息, 有利于后期的维护和排错.

如何实现

对于版本信息等, 有两种方式,
一种从外部获取, 比如配置文件等,
另一种从源代码中获取, 将配置信息写死在源代码中.

这两种都不太好, 比如编译时间就不太好确定.
最好是能在 go build 时确定这些信息.

幸好, go build 提供了一个选项叫做 -ldflags '[pattern=]arg list'.

-X importpath.name=value
    Set the value of the string variable in importpath named name to value.
    This is only effective if the variable is declared in the source code either uninitialized
    or initialized to a constant string expression. -X will not work if the initializer makes
    a function call or refers to other variables.
    Note that before Go 1.5 this option took two separate arguments.

这使得我们可以在编译生成二进制文件时, 指定某些变量的值.

比如我们有个文件是 company/buildinfo 包的一部分.

package buildinfo

var BuildTime string

运行 go build -ldflags="-X 'company/buildinfo.BuildTime=$(date)'" 会记录编译时间,
BuildTime 的值设置为编译时的时间, 即从 $(date) 中获取的时间.

参考:

实践

新增 pkg/version 包, 用于获取版本信息.

package version

// 这些值应该是从外部传入的
var (
    gitTag       string = ""
    gitCommit    string = "$Format:%H$"          // sha1 from git, output of $(git rev-parse HEAD)
    gitTreeState string = "not a git tree"       // state of git tree, either "clean" or "dirty"
    buildDate    string = "1970-01-01T00:00:00Z" // build date in ISO8601 format, output of $(date -u +'%Y-%m-%dT%H:%M:%SZ')
)
package version

import (
    "fmt"
    "runtime"
)

// 构建时的版本信息
type VersionInfo struct {
    GitTag       string `json:"git_tag"`
    GitCommit    string `json:"git_commit"`
    GitTreeState string `json:"git_tree_state"`
    BuildDate    string `json:"build_date"`
    GoVersion    string `json:"go_version"`
    Compiler     string `json:"compiler"`
    Platform     string `json:"platform"`
}

func (info VersionInfo) String() string {
    return info.GitTag
}

func Get() VersionInfo {
    return VersionInfo{
        GitTag:       gitTag,
        GitCommit:    gitCommit,
        GitTreeState: gitTreeState,
        BuildDate:    buildDate,
        GoVersion:    runtime.Version(),
        Compiler:     runtime.Compiler,
        Platform:     fmt.Sprintf("%s/%s", runtime.GOOS, runtime.GOARCH),
    }
}

主要定义了一个结构体, 保持版本信息.

有些信息可以通过 runtime 获取, 有些是编译时传进来的.

这里没有明确的版本号, 而是使用 git tag 作为版本标签.

最后, 定义一个命令 version.

package cmd

import (
    "encoding/json"
    "fmt"

    "github.com/spf13/cobra"
    "tzh.com/web/pkg/version"
)

var versionCmd = &cobra.Command{
    Use:   "version",
    Short: "Print the version info of server",
    Long:  "Print the version info of server",
    Run: func(cmd *cobra.Command, args []string) {
        printVersion()
    },
}

func printVersion() {
    info := version.Get()
    infoj, err := json.MarshalIndent(&info, "", " ") // 加一点缩进
    if err != nil {
        fmt.Printf("遇到了错误: %v\n", err)
    }
    fmt.Println(string(infoj))
}

别忘了使用 AddCommand 添加子命令.

// 初始化, 设置 flag 等
func init() {
    cobra.OnInitialize(initConfig)
    rootCmd.PersistentFlags().StringVarP(&cfgFile, "config", "c", "./conf/config.yaml", "config file (default: ./conf/config.yaml)")
    rootCmd.AddCommand(versionCmd)
}

由此, 代码基本已经改完了, 还剩下最后一点, 修改 Makefile 文件,
以便简化操作过程.

修改 Makefile

SHELL := /bin/bash
BASEDIR = $(shell pwd)

# build with version infos
versionDir = "tzh.com/web/pkg/version"
gitTag = $(shell if [ "`git describe --tags --abbrev=0 2>/dev/null`" != "" ];then git describe --tags --abbrev=0; else git log --pretty=format:'%h' -n 1; fi)
buildDate = $(shell TZ=UTC date +%FT%T%z)
gitCommit = $(shell git log --pretty=format:'%H' -n 1)
gitTreeState = $(shell if git status|grep -q 'clean';then echo clean; else echo dirty; fi)

ldflags="-w -X ${versionDir}.gitTag=${gitTag} -X ${versionDir}.buildDate=${buildDate} -X ${versionDir}.gitCommit=${gitCommit} -X ${versionDir}.gitTreeState=${gitTreeState}"

all: gotool build
build:
    go build -ldflags ${ldflags} ./
run:
    go run -ldflags ${ldflags} ./
docker:
    go run -ldflags ${ldflags} ./ -c ./conf/config_docker.yaml

首行定义了运行的 shell, 默认是 /bin/sh, 这里改成了更常用的 /bin/bash.

然后, 就是定义了一大堆需要的参数.
在运行 go build 的时候添加了参数 -ldflags ${ldflags}.

如此, 以后只要使用 make build 就能生成具有版本信息的二进制文件了.

编译好之后, 可以运行 ./web version 查看具体的版本信息.

总结

通过为编译时添加额外信息, 可以生成更具交互性的二进制文件.
同时, 也能体会到 Makefile 带来的便捷.

当前部分的代码

作为版本 v0.12.0

相关文章

  • 如何用 GVM 管理 Go 项目

    使用 Go 版本管理器管理多个版本的 Go 语言环境及其模块。 Go 语言版本管理器(GVM)是管理 Go 语言环...

  • 12使用 Go 管理版本

    简介 如何实现 实践 修改 Makefile 总结 当前部分的代码 简介 如果你曾经运行过 docker vers...

  • go包管理

    内容 1 gvm管理go版本2 git submodule3 go mod gvm使用 1 安装gvm 2 gvm...

  • 关于go module的使用

    在go1.11版本以后go modules成为了go官方的依赖管理方式,替换一起的Godep。使用go modul...

  • GO Modules 使用

    旧项目迁移,打算使用GO Modules 作为依赖管理。 go版本 1.12 私人依赖包,如何处理 1. 创建模块...

  • 10.手撕Go语言-包管理

    介绍 Go1.11版本提供Go modules机制对包进行管理,同时保留GOPATH和vendor机制,使用临时环...

  • 搭建Go语言开发环境

    Go语言1.14版本之后推荐使用go modules管理以来,也不再需要把代码写在GOPATH目录下了。 下载 下...

  • 1. 安装Go及搭建Go开发环境

    注意:Go语言1.14版本之后推荐使用go modules管理以来,也不再需要把代码写在GOPATH目录下了。无需...

  • go mod

    go mod 是官方go的管理依赖的工具,集成在go1.11版本以上。基于最小版本选择(mvs)管理。 1. 初始...

  • golang(1) go module 依赖包管理

    go module go module 是Go1.11版本之后官方推出的版本管理工具。并且从Go1.13版本开始,...

网友评论

    本文标题:12使用 Go 管理版本

    本文链接:https://www.haomeiwen.com/subject/zdjzvctx.html