zirra/golang

Golang通用构建镜像

镜像概述

本镜像为所有Golang相关应用提供通用的构建环境，旨在简化Golang应用的构建流程，确保构建环境的一致性和可重复性。通过集成必要的构建工具和依赖，帮助开发者快速搭建标准化的Golang构建环境。

核心功能与特性

• 多版本支持：可灵活配置不同Golang版本，满足不同项目的版本需求
• 工具集成：内置常用构建工具（go mod、git、make、gcc等）
• 环境标准化：提供统一的构建环境，避免因环境差异导致的构建问题
• 轻量级设计：优化镜像体积，减少资源占用
• 多阶段构建支持：可配合多阶段构建流程，减小最终应用镜像体积

使用场景

• 本地开发环境中的Golang应用构建
• CI/CD流水线中的自动化构建环节
• 团队协作中的统一构建标准实施
• 各类Golang项目（Web应用、命令行工具、库等）的构建过程

使用方法

基本构建命令

通过docker run命令直接使用镜像进行构建：

bash
docker run -v $(pwd):/app -e GOLANG_VERSION=1.21 docker.xuanyuan.run/golang-build-image:latest sh -c "cd /app && go build -o myapp"

环境变量配置

Docker Compose配置示例

yaml
version: '3.8'
services:
  golang-builder:
    image: docker.xuanyuan.run/golang-build-image:latest
    volumes:
      - ./:/app  # 将本地代码目录挂载到容器内
    environment:
      - GOLANG_VERSION=1.21
      - APP_PATH=/app
      - BUILD_CMD=go build -mod=mod -o myapp ./cmd/main.go
    command: sh -c "cd $APP_PATH && $BUILD_CMD"

多阶段构建示例

结合多阶段构建优化最终应用镜像：

dockerfile
# 阶段1：使用构建镜像编译应用
FROM golang-build-image:latest AS builder
WORKDIR /app
COPY . .
RUN go build -o myapp ./main.go

# 阶段2：构建轻量级运行镜像
FROM alpine:latest
COPY --from=builder /app/myapp /usr/local/***/
CMD ["myapp"]