Intégration d'informations dans les binaires Go 1.18

Le tant attendu Go 1.18 est enfin sorti. Cette mise à jour de version contient de nombreux contenus, notamment des génériques, des tests de fuzz, un espace de travail multi-modules, un nouveau package net/netip, une nouvelle fonction string.Cut, etc.

Peut-être que tout le monde a entendu parler des caractéristiques ci-dessus. Après avoir lu la note de version, j'ai remarqué une nouvelle fonctionnalité qui n'a peut-être pas été remarquée par tout le monde : l'intégration d'informations sur les fichiers binaires.

La raison pour laquelle nous prêtons attention à ce point est que nous venons d'aborder ce problème dans l'article Une solution différente de gestion des numéros de version du projet Go la semaine dernière, et on a l'impression qu'elle est liée à la solution officielle Parfait combo.

Intégration des informations de construction

Dans Go 1.18, via la commande go build build, nous pouvons intégrer des informations de construction dans le fichier binaire.

Ensuite, ressentons-le intuitivement à travers des exemples.

Tout d'abord, assurez-vous que la version Go 1.18 est installée via la commande go version.

$ go version
go version go1.18 darwin/amd64

Ensuite, initialisez l'environnement du projet

$ mkdir versionDemo
$ cd versionDemo
$ go mod init example/version
$ touch main.go

Dans main.go, écrivez une logique d'impression simple

package main

import (
 "fmt"
)

func main() {
 fmt.Println("HELLO GOPHER")
}

À ce stade, nous compilons et obtenons le fichier binaire

$ go build -o main1.18 example/version

Après avoir obtenu le fichier binaire, vous pouvez obtenir des méta-informations lors de la compilation du fichier via la commande suivante

$ go version -m main1.18
main1.18: go1.18
 path example/version
 mod example/version (devel)
 build -compiler=gc
 build CGO_ENABLED=1
 build CGO_CFLAGS=
 build CGO_CPPFLAGS=
 build CGO_CXXFLAGS=
 build CGO_LDFLAGS=
 build GOARCH=amd64
 build GOOS=darwin
 build GOAMD64=v1

可以看到，通过 <span style="font-size: 15px;">go version -m binaries</span> ，我们可以获取到二进制文件的各项构建信息。

当然，如果在构建过程中，为二进制文件指定了 -tags 等，我们同样能够以上的方式获取。

$ go build -tags version1.1 --ldflags="-X 'main.s=sss'" -o main1.18more example/version
$ go version -m main1.18more
main1.18more: go1.18
 path example/version
 mod example/version (devel)
 build -compiler=gc
 build -ldflags="-X 'main.s=sss'"
 build -tags=version1.1
 build CGO_ENABLED=1
 build CGO_CFLAGS=
 build CGO_CPPFLAGS=
 build CGO_CXXFLAGS=
 build CGO_LDFLAGS=
 build GOARCH=amd64
 build GOOS=darwin
 build GOAMD64=v1

VCS 信息嵌入

正如在一个不一样的 Go 项目版本号管理方案一文中探讨过的一样，版本信息不应该仅包含 Go 本身的信息，还应该包含 VCS 信息，例如 Git、Mercurial、Fossil 和 Bazaar。

在 Go 1.18，通过 go help build 命令，可以看到多了 -buildvcs 参数，它默认是打开的。

$ go help build
...
 -buildvcs
  Whether to stamp binaries with version control information. By default,
  version control information is stamped into a binary if the main package
  and the main module containing it are in the repository containing the
  current directory (if there is a repository). Use -buildvcs=false to
  omit version control information.
...

在上述项目中，我们添加 Git 版本控制。

$ git init
$ go build -o mainwithgit example/version
$ go version -m mainwithgit
mainwithgit: go1.18
 path example/version
 mod example/version (devel)
 build -compiler=gc
 build CGO_ENABLED=1
 build CGO_CFLAGS=
 build CGO_CPPFLAGS=
 build CGO_CXXFLAGS=
 build CGO_LDFLAGS=
 build GOARCH=amd64
 build GOOS=darwin
 build GOAMD64=v1
 build vcs=git
 build vcs.modified=true

此时，输出信息中多出了两列关于 vcs 的信息。接下来，我们将仓库内文件保存并提交。

$ git add go.mod main.go
$ git commit -m 'feat: this is a commit message'
$ go build -o mainwithgit example/version
$ go version -m mainwithgit
 $ go version -m mainwithgit
mainwithgit: go1.18
 path example/version
 mod example/version (devel)
 build -compiler=gc
 build CGO_ENABLED=1
 build CGO_CFLAGS=
 build CGO_CPPFLAGS=
 build CGO_CXXFLAGS=
 build CGO_LDFLAGS=
 build GOARCH=amd64
 build GOOS=darwin
 build GOAMD64=v1
 build vcs=git
 build vcs.revision=f28c77dfcfcfb5289fae9318d3ab3e487b8a3b37
 build vcs.time=2022-03-20T14:26:24Z
 build vcs.modified=true

二进制文件中记录了更详细 vcs 信息，包括 git 版本号，提交时间等。

出于某些原因，有时我们并不想二进制中包含这些 vcs 信息，这时，在构建时指定 <span style="font-size: 15px;">-buildvcs=false</span> 即可。

没有 Go 环境，如何查看嵌入信息

在上面的场景中，我们都是通过执行 <span style="font-size: 15px;">go version -m binaries</span>  命令查看二进制文件的嵌入信息的。但是，在能拿到二进制文件的场景下，并不总是存在 Go 环境，例如没有 Go 环境的远程服务器。这样的场景中，如何查看它的嵌入信息呢？

这时，可以通过 <span style="font-size: 15px;">runtime/debug.ReadBuildInfo</span> 获取。例如，我们将上述例子中的 main.go  的内容更改如下

package main

import (
 "fmt"
 "runtime/debug"
)

func main() {
 info, _ := debug.ReadBuildInfo()
 fmt.Println("=========== build info ===========")
 fmt.Println(info)
}

同样可得到构建信息如下

=========== build info ===========
go      go1.18
path    workspace/example/versionDemo
mod     workspace/example/versionDemo   (devel) 
build   -compiler=gc
build   CGO_ENABLED=1
build   CGO_CFLAGS=
build   CGO_CPPFLAGS=
build   CGO_CXXFLAGS=
build   CGO_LDFLAGS=
build   GOARCH=amd64
build   GOOS=darwin
build   GOAMD64=v1
build   vcs=git
build   vcs.revision=b3f9cd7b83d4e624be942365728d676dfdca6a3e
build   vcs.time=2022-03-20T14:10:44Z
build   vcs.modified=true

因此，为了解决没有 Go 环境的远程服务器不能查看嵌入信息的情况。我们不妨利用 <span style="font-size: 15px;">runtime/debug.ReadBuildInfo</span> 函数，将其封装为一个接口，访问该接口即可获取当前二进制文件的嵌入信息。

总结

其实在 1.18 之前的版本中，Go 二进制文件就包括了少许的嵌入信息。例如同样是上文中的项目，我们通过 1.16 构建二进制文件，读取它的嵌入信息，其仅包括了 path 与 mod 信息。

$ go1.16.4 build -o main1.16 example/version
$ go1.16.4 version -m main1.16
main1.16: go1.16.4
 path example/version
 mod example/version (devel)

在 1.18 中，通过丰富二进制文件的嵌入信息，能够让我们更好地了解到当前程序。例如利用 vcs 信息可以判断从三方获取的 Go 二进制文件是否是预期程序，代码提交的发版部署是否有误等。

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!