basefly/golang

golang builder镜像文档

镜像概述

本镜像为Go项目构建的专用builder阶段镜像，基于golang:${{ github.event.inputs.tag }}-alpine基础镜像构建。主要用于Docker多阶段构建流程中的编译阶段，提供完整的Go编译环境及必要工具，简化Go项目的构建流程。

核心功能与特性

基础环境

• 基础镜像：基于指定版本的golang-alpine镜像，兼具轻量级特性与完整的Go编译环境
• 环境配置：默认设置CGO_ENABLED=0（禁用CGO，生成静态链接二进制文件）和GOOS=linux（指定目标操作系统为Linux）

工具支持

• 预安装工具：包含git（用于版本控制或拉取依赖代码）和upx（用于压缩Go编译生成的二进制文件，显著减小文件体积）
• 包管理优化：使用阿里云Alpine镜像源（http://mirrors.aliyun.com/alpine/v3.10/main/和http://mirrors.aliyun.com/alpine/v3.10/community/）加速apk包安装

依赖加速

• Go代理配置：默认设置GOPROXY=https://goproxy.cn,direct，通过国内代理加速Go模块依赖下载，提升构建效率

使用场景

• Go项目的Docker多阶段构建流程，作为构建阶段（builder）编译Go源代码
• 需要生成体积优化的Go二进制文件的场景（通过upx压缩）
• 对构建速度有要求的场景（通过国内代理和镜像源加速依赖获取）

使用方法与配置说明

典型应用示例（Dockerfile片段）

dockerfile
# 使用本镜像作为builder阶段
FROM docker.xuanyuan.run/golang:${{ github.event.inputs.tag }}-alpine AS builder
LABEL stage=gobuilder
ENV CGO_ENABLED=0 GOOS=linux GOPROXY=https://goproxy.cn,direct
RUN echo http://mirrors.aliyun.com/alpine/v3.10/main/ > /etc/apk/repositories && \
    echo http://mirrors.aliyun.com/alpine/v3.10/community/ >> /etc/apk/repositories && \
    apk update --no-cache && \
    apk add --no-cache git upx

# 编译Go项目
WORKDIR /app
COPY . .
RUN go mod download
RUN go build -o app main.go

# 使用upx压缩二进制文件
RUN upx app

# 构建最终运行镜像（示例）
FROM docker.xuanyuan.run/alpine:3.10
WORKDIR /app
COPY --from=builder /app/app .
CMD ["./app"]

环境变量说明

工具使用说明

• git：可直接用于拉取代码或依赖，例如 git clone <repository-url>
• upx：用于压缩二进制文件，基本用法为 upx <binary-file>，压缩后可显著减小文件体积（通常可减少30%-50%）