thedumptruck/golang

golang-docker-onbuild

镜像概述

golang-docker-onbuild是一系列针对Golang应用设计的On Build Docker镜像，旨在简化Golang应用的Docker化构建流程。该镜像通过预定义构建阶段的自动化指令，自动完成代码复制、依赖安装、应用编译等步骤，帮助开发者快速生成可运行的Golang应用镜像，减少手动配置成本。

核心功能与特性

• 自动化构建流程：内置On Build指令，自动执行代码复制、依赖下载、应用编译等构建步骤
• 多版本支持：提供针对不同Golang版本的镜像变体，适配不同项目的版本需求
• 简化配置：开发者无需编写复杂的Dockerfile构建步骤，仅需基础配置即可完成镜像构建
• 标准化输出：构建产物遵循统一标准，确保生成的应用镜像结构一致、可移植性强

使用场景

• 快速将Golang应用容器化的开发场景
• 需要简化Dockerfile编写的中小型Golang项目
• 持续集成/持续部署(CI/CD)流程中自动化构建Golang应用镜像
• 对构建流程标准化有需求的团队或项目

使用方法

基本使用

1. 创建Dockerfile
   在Golang项目根目录下创建简单的Dockerfile，直接基于golang-docker-onbuild镜像：

   dockerfile
   FROM golang-docker-onbuild
   

2. 构建镜像
   执行以下命令构建应用镜像：

   bash
   docker build -t my-golang-app .
   

   构建过程中，镜像会自动执行以下步骤：

   • 复制项目源代码到容器内
   • 下载项目依赖（执行go mod download或go get）
   • 编译Golang应用（执行go build）
   • 设置应用入口命令

3. 运行容器
   构建完成后，通过以下命令运行应用：

   bash
   docker run -p 8080:8080 my-golang-app
   

高级配置（可选）

若需自定义构建行为，可在Dockerfile中添加额外指令覆盖默认行为，例如指定编译参数：

dockerfile
FROM golang-docker-onbuild
ENV CGO_ENABLED=0
ENV GOOS=linux
CMD ["./my-app", "--port=8080"]

注意事项

• 确保项目根目录包含有效的Golang项目结构（如go.mod文件）
• 根据项目需求选择对应Golang版本的镜像变体（如golang-docker-onbuild:1.20）
• 构建过程中需保证网络通畅，以便正常下载依赖包