itzg/go-alpine-build

itzg/go-alpine-build 镜像文档

镜像概述

该镜像用于构建与Alpine系统兼容的Golang应用程序。由于Alpine使用musl libc而非标准glibc，常规针对"linux"平台编译的Golang程序无法在Alpine上运行。本镜像基于https://hub.docker.com/_/golang/%E7%9A%84alpine%E6%A0%87%E7%AD%BE%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%B9%B6%E9%A2%84%E5%85%88%E5%AE%89%E8%A3%85%E4%BA%86git%E5%92%8Cglide%E4%BE%9D%E8%B5%96%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7%E3%80%82

核心功能和特性

• 基于官方Golang Alpine镜像，确保构建环境一致性
• 预装git版本控制工具，支持从代码仓库拉取依赖
• 集成glide依赖管理工具，简化Golang项目依赖管理
• 专门针对Alpine的musl libc环境优化，确保构建产物兼容性

使用场景

• 需要为Alpine Linux系统开发和构建Golang应用程序的场景
• 希望在容器化环境中实现Golang应用的跨平台构建
• 需要自动化构建流程中集成Alpine兼容的Golang编译步骤

使用方法

基本构建流程

1. 将待构建的项目目录挂载到容器内/go/src下的相应子路径
2. 使用-w参数设置工作目录为挂载路径
3. 镜像名称后可传递参数作为构建输出文件的名称（通过-o指定）

构建示例

以构建haproxy-gen项目为例：

bash
# 克隆项目代码
git clone https://github.com/itzg/haproxy-gen.git
cd haproxy-gen

# 执行容器构建
docker run --rm \
  -v $(pwd):/go/src/github.com/itzg/haproxy-gen \
  -w /go/src/github.com/itzg/haproxy-gen \
  itzg/go-alpine-build dist/haproxy-gen-alpine

构建完成后，可在项目的dist目录下找到生成的可执行文件haproxy-gen-alpine。

配置选项

环境变量

例如，跳过依赖安装步骤的构建命令：

bash
docker run --rm \
  -e SKIP_GLIDE=1 \
  -v $(pwd):/go/src/github.com/itzg/haproxy-gen \
  -w /go/src/github.com/itzg/haproxy-gen \
  itzg/go-alpine-build dist/haproxy-gen-alpine