運行工作流，可以看到構(gòu)建變量已經(jīng)成功的透傳，并且替換了預(yù)設(shè)的變量模板。

部署后查看控制臺，可以看到 Zadig 的構(gòu)建信息已經(jīng)可以在 console 中顯示。

由于后端二進制交付物背后的項目類型比較多，這里主要介紹 Golang 項目一種實現(xiàn)思路，該部分涉及到的源碼可以點擊鏈接[9]查看，其他項目類型可以根據(jù)實際情況進行參考和配置。

1. 定義版本信息

這里在項目中維護一份 version.go 文件，根據(jù)實際需求，定義需要暴露的參數(shù)。

package utilsimport (    "fmt"    "runtime")var (    version      string    gitBranch    string    gitTag       string    gitCommit    string    gitPR        string    gitTreeState string    buildDate    string    buildURL      string)// Info contains versioning information.type Info struct {    Version      string `json:"version"`    GitBranch    string `json:"gitBranch"`    GitTag       string `json:"gitTag"`    GitCommit    string `json:"gitCommit"`    GitPR        string `json:"gitPR"`    GitTreeState string `json:"gitTreeState"`    BuildDate    string `json:"buildDate"`    BuildURL     string `json:"buildURL"`    GoVersion    string `json:"goVersion"`    Compiler     string `json:"compiler"`    Platform     string `json:"platform"`}// String returns info as a human-friendly version string.func (info Info) String() string {    return info.Platform}func GetVersion() Info {    return Info{        Version:      version,        GitBranch:    gitBranch,        GitTag:       gitTag,        GitCommit:    gitCommit,        GitPR:        gitPR,        GitTreeState: gitTreeState,        BuildDate:    buildDate,        BuildURL:     buildURL,        GoVersion:    runtime.Version(),        Compiler:     runtime.Compiler,        Platform:     fmt.Sprintf("%s/%s", runtime.GOOS, runtime.GOARCH),    }}

2. main 函數(shù)調(diào)用

在入口處設(shè)置傳入version參數(shù)調(diào)用GetVersion函數(shù)：

package mainimport (    "fmt"    "os"    "version/utils")func main() {    args := os.Args    if len(args) >= 2 && args[1] == "version" {        v := utils.GetVersion()        fmt.Printf("Version: %s\nBranch: %s\nCommit: %s\nPR: %s\nBuild Time: %s\nGo Version: %s\nOS/Arch: %s\nBuild URL: %s\n", v.Version, v.GitBranch, v.GitCommit,v.GitPR, v.BuildDate, v.GoVersion, v.Platform,v.BuildURL)    } else {        fmt.Printf("Version(hard code): %s\n", "0.1")    }}

3. 構(gòu)建工程文件編寫

這里新建一個 Makefile 進行構(gòu)建，使用ldflags -X透傳 Zadig 構(gòu)建內(nèi)置變量，核心邏輯如下：

# build with verison infosversinotallow="version/utils"gitTag=$(version_TAG)gitBranch=$(version_BRANCH)gitPR=$(version_PR)buildDate=$(shell TZ=Asia/Shanghai date +%FT%T%z)gitCommit=$(version_COMMIT_ID)gitTreeState=$(shell if git status|grep -q "clean";then echo clean; else echo dirty; fi)buildURL=$(BUILD_URL)ldflags="-s -w -X ${versionDir}.gitTag=${gitTag} -X ${versionDir}.buildDate=${buildDate} -X ${versionDir}.gitCommit=${gitCommit} -X ${versionDir}.gitPR=${gitPR} -X ${versionDir}.gitTreeState=${gitTreeState} -X ${versionDir}.versinotallow=${VERSION} -X ${versionDir}.gitBranch=${gitBranch} -X ${versionDir}.buildURL=${buildURL}"PACKAGES=`go list ./... | grep -v /vendor/`VETPACKAGES=`go list ./... | grep -v /vendor/ | grep -v /examples/`GOFILES=`find . -name "*.go" -type f -not -path "./vendor/*"`default:    @echo "build the ${BINARY}"    @GOOS=linux GOARCH=amd64 go build -ldflags ${ldflags} -o  build/${BINARY}.linux  -tags=jsoniter    @go build -ldflags ${ldflags} -o  build/${BINARY}.mac  -tags=jsoniter    @echo "build done."

在 Zadig 中配置構(gòu)建，在構(gòu)建腳本中構(gòu)建并打印輸出，詳細(xì)信息如下：

set -ecd $WORKSPACE/zadig/examples/version-demoenvmake defaultcd build./version.linux version

運行工作流，可以看到構(gòu)建變量已經(jīng)成功的透傳，并且該二進制程序通過version參數(shù)可以打印詳細(xì)的構(gòu)建來源信息。

以上，就是一些常見交付物類型在 Zadig 上的溯源思路總結(jié)，相比于通過原始的 Image ID 、Digest ....來反推進行追蹤，該流程可以讓用戶以及開發(fā)人員通過更簡單便捷的方式上報或者追蹤交付物問題，提高問題排查定位的效率。

[1]https://docs.docker.com/config/labels-custom-metadata/

[2]https://github.com/opencontainers/image-spec/blob/main/annotations.md

[3]https://docs.docker.com/engine/reference/builder/#label

[4]https://docs.docker.com/engine/reference/builder/#arg

[5] https://github.com/koderover/zadig-portal/blob/main/Dockerfile

[6] https://webpack.js.org/plugins/define-plugin/

[7] https://webpack.js.org/plugins/environment-plugin/#root

[8]https://nodejs.org/api/process.html#process_process_env

[9]https://github.com/koderover/zadig/tree/main/examples/version-demo

[10] https://pkg.go.dev/cmd/link

[11]https://github.com/kubernetes/kubectl/blob/master/pkg/cmd/version/version.go

[12] https://github.com/kubernetes/component-base/blob/master/version/version.go

[13] https://zhuanlan.zhihu.com/p/150991555

關(guān)鍵詞：