prom/golang-builder

Prometheus Golang builder Docker镜像

镜像概述与主要用途

Prometheus Golang builder是用于跨平台构建Golang Prometheus项目的Docker构建镜像。该镜像提供标准化的构建环境，支持为多种架构编译Prometheus相关Golang应用，简化跨平台构建流程。

核心功能与特性

• 跨平台构建支持：支持为多种操作系统和架构（如Linux、Darwin、Windows、FreeBSD等）构建二进制文件。
• 多架构覆盖：提供针对主流架构的专用镜像，包括基础架构（main）、ARM、PowerPC、MIPS等。
• 多Go版本支持：包含Go 1.5和Go 1.6系列版本，满足不同项目的依赖需求。
• 集成测试能力：支持通过命令行选项直接运行项目测试用例。
• 标准化构建流程：基于Makefile实现统一的构建和测试流程，简化项目集成。

支持的镜像标签

以下是可用的镜像标签及其对应的架构和Dockerfile链接：

使用场景

• 多架构部署需求：需为ARM、PowerPC等非x86架构构建Prometheus相关组件的场景。
• 统一构建环境：在团队或CI/CD流程中标准化构建环境，避免本地环境差异导致的构建问题。
• 跨平台应用发布：需同时发布Linux、Windows、macOS等多平台版本的Golang应用。
• 自动化测试集成：在Docker环境中执行项目测试，确保测试环境一致性。

使用方法

前提条件

• 项目根目录需包含Makefile，且定义build（构建目标）和test（测试目标）命令。
• 本地需安装Docker环境。

命令参数说明

构建脚本builder.sh支持以下参数：

示例命令

1. 基础架构版本（main/latest标签）

适用于主流架构（如amd64、386等）的跨平台构建：

bash
docker run --rm -ti -v $(pwd):/app prom/golang-builder:main \
    -i "github.com/prometheus/prometheus" \
    -p "linux/amd64 linux/386 darwin/amd64 darwin/386 windows/amd64 windows/386 freebsd/amd64 freebsd/386 openbsd/amd64 openbsd/386 netbsd/amd64 netbsd/386 dragonfly/amd64"

2. ARM架构版本（arm标签）

针对ARM架构（如arm、arm64）的构建：

bash
docker run --rm -ti -v $(pwd):/app prom/golang-builder:arm \
    -i "github.com/prometheus/prometheus" \
    -p "linux/arm linux/arm64 freebsd/arm openbsd/arm netbsd/arm"

3. PowerPC架构版本（powerpc标签）

针对PowerPC架构（如ppc64、ppc64le）的构建：

bash
docker run --rm -ti -v $(pwd):/app prom/golang-builder:powerpc \
    -i "github.com/prometheus/prometheus" \
    -p "linux/ppc64 linux/ppc64le"

4. MIPS架构版本（mips标签）

针对MIPS架构（mips64、mips64le）的构建（需Go 1.6及以上版本）：

bash
docker run --rm -ti -v $(pwd):/app prom/golang-builder:mips \
    -i "github.com/prometheus/prometheus" \
    -p "linux/mips64 linux/mips64le"

5. 仅运行测试（-T选项）

使用-T参数运行项目测试用例：

bash
docker run --rm -ti -v $(pwd):/app prom/golang-builder:main \
    -i "github.com/prometheus/prometheus" \
    -T

***声明

OSX/Darwin/Apple平台构建注意事项：
使用本镜像构建OSX/Darwin/Apple平台的二进制文件前，请确保您已阅读并同意Xcode许可条款。

更多信息

• 项目包含CircleCI配置文件（circle.yml），可用于自动化构建流程。
• 核心开发者可通过Prometheus开发者邮件列表或IRC频道（#prometheus on irc.freenode.net）获取支持。

贡献指南

详见CONTRIBUTING.md。

许可证

本项目采用Apache License 2.0许可，详见LICENSE。