alexfalkowski/go-service-template

Go服务Docker模板镜像

概述

该镜像为Go服务开发提供标准化Docker模板，集成Go语言开发与运行时环境的最佳实践，旨在帮助开发者快速实现Go服务的容器化，减少环境配置工作量，专注于业务逻辑开发。

核心功能与特性

• 基础环境标准化：基于官方Go镜像构建，预置Go工具链（go mod、go vet、go test等），确保开发环境一致性
• 多阶段构建支持：内置构建流程优化，支持源码编译与运行环境分离，显著减小最终镜像体积
• 灵活定制能力：通过环境变量和构建参数调整编译选项、依赖管理策略及运行时配置
• 开发/生产环境适配：支持开发阶段热重载配置与生产环境安全加固，满足不同场景需求
• 兼容性良好：兼容主流容器化工具（Docker Compose、Kubernetes）及CI/CD流程集成

使用场景

• Go微服务快速容器化部署
• 开发团队统一开发环境配置
• CI/CD流水线中自动化构建Go服务镜像
• 小型Go应用原型验证与测试部署
• 需要跨平台分发的Go服务打包

使用方法

基础使用流程

1. 创建项目结构

bash
mkdir -p my-go-service && cd my-go-service
touch main.go Dockerfile

2. 编写Go服务代码（示例main.go）

go
package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Hello from Go service!")
    })
    port := ":8080"
    fmt.Printf("Service starting on %s\n", port)
    http.ListenAndServe(port, nil)
}

3. 创建自定义Dockerfile（基于模板镜像）

dockerfile
# 阶段1: 使用模板镜像构建应用
FROM docker.xuanyuan.run/[模板镜像名称]:latest AS builder
WORKDIR /app
COPY . .
RUN go mod download
RUN CGO_ENABLED=0 GOOS=linux go build -o app .

# 阶段2: 构建运行镜像
FROM docker.xuanyuan.run/alpine:latest
WORKDIR /app
COPY --from=builder /app/app .
EXPOSE 8080
CMD ["./app"]

4. 构建并运行

bash
docker build -t my-go-service .
docker run -p 8080:8080 docker.xuanyuan.run/my-go-service

Docker Compose配置示例

yaml
version: '3.8'
services:
  go-service:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    environment:
      - GOPROXY=https://goproxy.cn,direct  # 配置国内代理加速依赖下载
      - APP_ENV=production                  # 指定运行环境
    restart: unless-stopped

配置说明

环境变量

构建参数

可通过--build-arg调整构建行为：

• GO_VERSION：指定基础Go镜像版本（如1.21.0），默认使用最新稳定版
• TARGET_PLATFORM：指定构建目标平台（如linux/amd64、linux/arm64）
• LDFLAGS：传递给go build的链接参数（如-s -w减小二进制体积）

注意事项

• 生产环境建议通过多阶段构建分离构建环境与运行环境，仅保留必要运行时依赖
• 如需使用CGO特性，需在构建阶段设置CGO_ENABLED=1并确保基础镜像包含对应编译器
• 敏感配置（如密钥、数据库连接串）建议通过容器编排平台的 secrets 机制注入，避免硬编码