Prometheus构建发布工具 promu 使用

k8s技术圈

共 2792字,需浏览 6分钟

 ·

2022-03-08 08:08

众所周知,Go语言中打包命令是 go build。在项目中,你可以单独使用 go build 命令对项目进行编译打包,也可以根据自己的需要,在该命令后加各种参数。prometheus官方为了统一项目(包括 prometheus、alertmanager和各种官方的 exporter)的编译和打包,开发了 promu 工具。

官方对 promu 工具的介绍:

`promu is the utility tool for building and releasing Prometheus projects``# promu是一个构建和发行Prometheus项目的实用工具`

promu工具的获取

源码编译

git clone https://github.com/prometheus/promu.git
make build

直接下载可执行文件

curl -s -L https://github.com/prometheus/promu/releases/download/v0.5.0/promu-0.5.0.linux-amd64.tar.gz | tar -xvzf - -C /tmp

promu配置文件介绍

promu使用过程中,最重要的配置文件是 .promu.yml,但是,官网上除了对promu工具参数的简单解释外,没有对 .promu.yml的编写进行说明,下面我们对一些常用的配置进行说明(可能官方觉得既然都要去编译prometheus项目了,那肯定会去看代码的,所以就不写文档了)

下面这个.promu.yml文件,就是在我的一个go项目中使用promu工具进行打包的配置文件

# go相关的基本配置
go:
  cgo: true
repository:
  # module name
  path: woqutech.com/jianqiang.zhu/my-golang
# 构建
build:
  binaries:
      # 输出的二进制包名称
    - name: woqu
      # main方法所在go文件的位置
      path: ./
  flags: -a -tags netgo
  # 编译时注入变量,结合prometheus的version包使用
  ldflags: |
    -X github.com/prometheus/common/version.Version={{.Version}}
    -X github.com/prometheus/common/version.Revision={{.Revision}}
    -X github.com/prometheus/common/version.Branch={{.Branch}}
    -X github.com/prometheus/common/version.BuildUser={{user}}@{{host}}
    -X github.com/prometheus/common/version.BuildDate={{date "20060102-15:04:05"}}
# 打包,将生成的二进制包和files下列出的文件进行打包
tarball:
  files:
    - default.yml
    - README.md
# 交叉编译
crossbuild:
  platforms:
    - linux/amd64
    - linux/386

go标签

(1)cgo

go语言提供了CGO机制,使得能够在go代码中直接调用C的库函数,大大提高了效率,减少了重复开发工作,如果你的项目中引用了用CGO写成的库,在编译时要把CGO_ENABLED=1开起来。如在使用go-sqlite3

(2)Oracle exporter 需要oracle提供的OCI或ODPI动态链接库支持,需要开启CGO特性

(3)网上说使用CGO的库,会使整个系统的性能大大降低。goroutine 通过 CGO 进入到 C 接口的执行阶段后,已经脱离了 golang 运行时的调度并且会独占线程,此时实际上变成了多线程同步的编程模型。如果 C 接口里有阻塞操作,这时候可能会导致所有线程都处于阻塞状态?

repository标签

(1)path

- path后所填的变量为你的模块,go语言在1.11后,官方支持了模块,即Go Modules,使用go mod命令实现

- 当你在你项目的根目录执行 go mod init woqutech.com/jianqiang.zhu/my-golang后,当前目录就变成了一个go模块,并会生成一个go.mod文件

- 若path后所填不是模块名,promu工具编译时则会去GOPATH或GOROOT目录下找,如下图:

build标签

(1)binaries

- 输出的二进制包的名字:name

- 指定main包的位置:path

- 可以以yml列表的形式编写多个,执行build命令后生成多个二进制包

(2)flags

-a:强制重新构建

-tags:TODO,还不清楚具体干啥

(3)ldflags

编译时加上ldflags属性,可以设置变量的值,在prometheus项目中通常用来设置版本等基础信息(当前项目必需被git所管理,否则编译时获取不到分支等信息),并结合prometheus的version包来使用,下面是个简单的例子:

package main
  
import "gopkg.in/alecthomas/kingpin.v2"
import "github.com/prometheus/common/version"
  
func main() {
    kingpin.Version(version.Print("woqu"))
    kingpin.Parse()
}

- 命令:  ./promu  build

tarball标签

(1)files

编译完成之后,你可能需要将二进制文件和其他文件一起打个包,则可使用这个命令

命令:  ./promu tarball

crossbuild标签

golang支持交叉编译,我们生产环境均为linux/amd64环境,无需使用该功能,不然多环境的使用会引入不必要的麻烦。

但是某些依赖库在操作系统上安装部署非常麻烦,可以借助crossbuild在docker环境中构建可执行程序。

原文链接:http://blog.lujianxin.com/x/art/mwuvnoldjj83

浏览 55
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报