multiarch/goxc Docker 镜像 - 轩辕镜像

docker-goxc Docker镜像

!logo

• Docker Hub: [***]

镜像概述

docker-goxc是goxc工具的Docker镜像封装，goxc是一款Go语言构建工具，专注于跨平台编译、应用打包及部署流程。该镜像提供了便捷的跨编译环境，无需在本地配置复杂的Go交叉编译工具链，即可为多种操作系统和架构构建Go应用。

核心功能与特性

• 跨平台编译：支持为多种操作系统（Linux、Darwin、Windows等）和架构（386、amd64、arm等）构建可执行文件
• 灵活的平台过滤：可通过参数指定目标架构、操作系统及构建约束，精准控制编译范围
• 任务管理：支持自定义构建任务流程，包括工具链安装、资源复制、打包等任务的组合与排除
• 配置支持：提供配置文件管理，支持自定义配置名称及配置覆写
• 版本控制：支持指定包版本、预发布信息、分支名称等版本相关参数
• 打包功能：内置归档功能，支持生成ZIP、TAR.GZ等格式的包文件

使用场景

• Go项目的跨平台分发，需为不同操作系统和硬件架构提供可执行文件
• 简化CI/CD流程中的跨编译环节，无需在构建服务器手动配置多平台编译环境
• 快速验证Go应用在不同目标平台的兼容性
• 自动化构建并打包Go应用，包含必要资源文件

使用方法与配置说明

基本使用

通过以下命令可快速查看goxc工具的帮助信息：

console
$ docker run -it --rm multiarch/goxc goxc -h
 goxc version: 0.17.1
  build date:
Usage: goxc [<option(s)>] [<task(s)>]
Help Options:
  -h <topic>     帮助 - 默认主题为'options'。也可指定'tasks'或任何任务/别名名称
  -ht            帮助 - 显示任务（及任务别名）
  -version       打印版本信息
  -v             详细输出
Help Topics:
  options           默认)
  tasks         列出所有任务和别名
  <task-name>   任务描述、任务选项和默认值
  <alias-name>  列出别名对应的任务
Tasks options:
  -+tasks=       首先运行的额外任务。参见'-help tasks'获取任务列表
  -t             构建交叉编译器工具链。等同于-tasks=toolchain
  -tasks+=       最后运行的额外任务。参见'-help tasks'获取任务列表
  -tasks-=       排除的任务。参见'-help tasks'获取任务列表
Platform filtering:
  -arch=         指定架构（默认所有架构 - "386 amd64 arm"）
  -bc=           指定构建约束（例如'linux,arm windows'）
  -os=           指定操作系统（默认所有操作系统 - "linux darwin windows freebsd openbsd solaris dragonfly"）
Config files:
  -c=            配置名称
  -wc            （覆）写配置。覆写为累加式。尝试使用goxc -wc生成初始配置
Package versioning:
  -br=           分支名称（用于fork的仓库）
  -bu=           构建名称（用于预发布构建）
  -pr=           预发布信息（通常为'alpha'、'snapshot'等）
  -pv=           包版本（通常为[major].[minor].[patch]，默认'snapshot'）
Build:
  -build-ccflags= 构建标志'print-commands'
  -build-compiler= 构建标志'compiler'
  -build-gccgoflags= 构建标志
  -build-gcflags= 构建标志
  -build-installsuffix= 构建标志
  -build-ldflags= 构建标志
  -build-print-commands= 构建标志'print-commands'
  -build-processors= 构建时使用的处理器数量
  -build-race=   构建标志'race'
  -build-tags=   构建标志
  -build-verbose= 构建标志'verbose'
Other options:
  -codesign=     用于签名darwin二进制文件的身份（仅在主机OS为'darwin'时应用）
  -d=            目标根目录（默认$GOBIN/(appname)-xc）
  -env=          使用环境变量
  -goroot=       指定Go根目录（当存在多个Go安装时有用）
  -include=      归档中包含的资源（默认=INSTALL*,README*,LICENSE*）
  -main-dirs-exclude= 从'main'包中排除的逗号分隔目录（默认=Godeps,testdata,_project,vendor）
  -max-processors= 最大处理器数量（用于并行任务）
  -n=            应用名称。默认是目录名称
  -o=            编译输出文件名（字符串模板，默认-o="{{.Dest}}{{.PS}}{{.Version}}{{.PS}}{{.Os}}_{{.Arch}}{{.PS}}{{.ExeName}}{{.Ext}}"）
  -pi=           已弃用的选项名称。使用-pr代替
  -q=            安静模式（仅输出错误）
  -resources-exclude= 归档中排除的资源（默认=*.go）
  -resources-include= 归档中包含的资源（默认=INSTALL*,README*,LICENSE*）
  -wd=           指定工作目录
  -wlc=          写入'local'配置

参数说明

帮助选项

• -h <topic>: 查看帮助信息，默认主题为options，可指定tasks或具体任务/别名名称
• -ht: 显示所有任务及别名
• -version: 打印版本信息
• -v: 详细输出模式

任务选项

• -+tasks=: 首先运行的额外任务，需从任务列表中选择
• -t: 构建交叉编译器工具链，等同于-tasks=toolchain
• -tasks+=: 最后运行的额外任务，需从任务列表中选择
• -tasks-=: 排除的任务，需从任务列表中选择

平台过滤

• -arch=: 指定目标架构，默认支持"386 amd64 arm"
• -bc=: 指定构建约束，例如'linux,arm windows'
• -os=: 指定目标操作系统，默认支持"linux darwin windows freebsd openbsd solaris dragonfly"

配置文件

• -c=: 配置名称
• -wc: （覆）写配置，覆写为累加式，可用于生成初始配置

包版本控制

• -br=: 分支名称（用于fork的仓库）
• -bu=: 构建名称（用于预发布构建）
• -pr=: 预发布信息（如'alpha'、'snapshot'）
• -pv=: 包版本，默认'snapshot'

构建选项

• -build-ccflags=: 构建标志'print-commands'
• -build-compiler=: 构建标志'compiler'
• -build-gccgoflags=: Go编译器标志
• -build-gcflags=: Go编译器标志
• -build-installsuffix=: 构建标志
• -build-ldflags=: 链接器标志
• -build-print-commands=: 构建标志'print-commands'
• -build-processors=: 构建时使用的处理器数量
• -build-race=: 构建标志'race'（启用数据竞争检测）
• -build-tags=: 构建标签
• -build-verbose=: 构建标志'verbose'（详细构建输出）

其他选项

• -d=: 目标根目录，默认$GOBIN/(appname)-xc
• -env=: 设置环境变量
• -goroot=: 指定Go根目录
• -include=: 归档中包含的资源文件，默认"INSTALL*,README*,LICENSE*"
• -n=: 应用名称，默认使用目录名称
• -o=: 输出文件名模板
• -q=: 安静模式，仅输出错误信息
• -wd=: 指定工作目录

部署示例

示例1：本地项目跨平台构建（scaleway/scaleway-cli）

从本地构建scaleway-cli项目，生成多平台可执行文件及归档包：

console
$ docker run -it --rm -v $(pwd):/go/src/github.com/scaleway/scaleway-cli -w /go/src/github.com/scaleway/scaleway-cli multiarch/goxc goxc -env=GO15VENDOREXPERIMENT=1
Adding GO15VENDOREXPERIMENT=1
[goxc:go-install] 2016/01/11 10:31:27 Task go-install succeeded
[goxc:xc] 2016/01/11 10:31:27 Parallelizing xc for 13 platforms, using max 7 of 8 processors
[goxc:xc] 2016/01/11 10:32:17 Task xc succeeded
[goxc:codesign] 2016/01/11 10:32:17 Task codesign succeeded
[goxc:copy-resources] 2016/01/11 10:32:17 Task copy-resources succeeded
[goxc:archive-zip] 2016/01/11 10:32:18 Artifact(s) archived to /go/src/github.com/scaleway/scaleway-cli/dist/1.7.0-rc1/scw_1.7.0-rc1_windows_386.zip
[goxc:archive-zip] 2016/01/11 10:32:18 Artifact(s) archived to /go/src/github.com/scaleway/scaleway-cli/dist/1.7.0-rc1/scw_1.7.0-rc1_freebsd_386.zip
[goxc:archive-zip] 2016/01/11 10:32:18 Artifact(s) archived to /go/src/github.com/scaleway/scaleway-cli/dist/1.7.0-rc1/scw_1.7.0-rc1_freebsd_arm.zip
[goxc:archive-zip] 2016/01/11 10:32:18 Artifact(s) archived to /go/src/github.com/scaleway/scaleway-cli/dist/1.7.0-rc1/scw_1.7.0-rc1_windows_amd64.zip
[goxc:archive-zip] 2016/01/11 10:32:18 Artifact(s) archived to /go/src/github.com/scaleway/scaleway-cli/dist/1.7.0-rc1/scw_1.7.0-rc1_freebsd_amd64.zip
[goxc:archive-zip] 2016/01/11 10:32:19 Artifact(s) archived to /go/src/github.com/scaleway/scaleway-cli/dist/1.7.0-rc1/scw_1.7.0-rc1_darwin_386.zip
[goxc:archive-zip] 2016/01/11 10:32:19 Artifact(s) archived to /go/src/github.com/scaleway/scaleway-cli/dist/1.7.0-rc1/scw_1.7.0-rc1_darwin_amd64.zip
[goxc:archive-zip] 2016/01/11 10:32:20 Task archive-zip succeeded
[goxc:archive-tar-gz] 2016/01/11 10:32:22 Task archive-tar-gz succeeded
[goxc:deb] 2016/01/11 10:32:28 Task deb succeeded
[goxc:deb-dev] 2016/01/11 10:32:28 Task deb-dev succeeded
[goxc:downloads-page] 2016/01/11 10:32:28 Task downloads-page succeeded
[goxc:deb-source] 2016/01/11 10:32:30 Task deb-source succeeded
[goxc:downloads-page] 2016/01/11 10:32:30 Task downloads-page succeeded
$ 

示例2：拉取GitHub项目构建（moul/anonuuid）

从GitHub拉取项目并构建Linux平台的可执行文件，仅需docker环境：

console
$ docker run -it --rm -v /tmp:/dist multiarch/goxc sh -xec 'go get -d github.com/moul/anonuuid; goxc -bc=linux -wd /go/src/github.com/moul/anonuuid -env=GO15VENDOREXPERIMENT=1 -d /dist xc'
+ go get -d github.com/moul/anonuuid
+ goxc -bc=linux -wd /go/src/github.com/moul/anonuuid -env=GO15VENDOREXPERIMENT=1 -d /dist xc
Adding GO15VENDOREXPERIMENT=1
[goxc:xc] 2016/01/11 11:57:19 Parallelizing xc for 3 platforms, using max 7 of 8 processors
[goxc:xc] 2016/01/11 11:57:21 Task xc succeeded
$ find /tmp/snapshot/ -ls
33685520    4 drwxr-xr-x   5 moul     moul         4096 Jan 11 12:55 /tmp/snapshot/
33685522    4 drwxr-xr-x   2 moul     moul         4096 Jan 11 12:57 /tmp/snapshot/linux_arm
33685550 3360 -rwxr-xr-x   1 moul     moul      3437720 Jan 11 12:57 /tmp/snapshot/linux_arm/anonuuid
33685549    4 drwxr-xr-x   2 moul     moul         4096 Jan 11 12:57 /tmp/snapshot/linux_386
33685559 3368 -rwxr-xr-x   1 moul     moul      3448120 Jan 11 12:57 /tmp/snapshot/linux_386/anonuuid
33685521    4 drwxr-xr-x   2 moul     moul         4096 Jan 11 12:57 /tmp/snapshot/linux_amd64
33685560 4180 -rwxr-xr-x   1 moul     moul      4279736 Jan 11 12:57 /tmp/snapshot/linux_amd64/anonuuid
$

更多示例

• scaleway-community/scaleway-docker

许可证

MIT许可证