docker.go 镜像文档

镜像概述和主要用途

docker.go 是一款专为Golang应用设计的Docker镜像，经过严格测试验证，确保在生产环境中具备稳定可靠的运行能力。该镜像基于官方Golang基础镜像优化构建，旨在为Golang应用提供一致、高效的容器化运行环境，简化从开发到生产的部署流程。

核心功能和特性

• 生产级稳定性：经过全面测试验证，符合生产环境对可靠性和稳定性的要求，降低部署风险
• 官方Golang版本支持：同步支持官方Golang稳定版本，确保开发与运行环境版本一致性
• 轻量级优化：采用精简基础镜像（如Alpine），减少镜像体积，提升资源利用率和部署速度
• 安全加固：默认启用非root用户运行、最小权限原则及基础安全配置，降低运行时安全风险
• CI/CD友好：提供标准化接口，易于集成主流CI/CD工具（Jenkins、GitLab CI、GitHub Actions等）

使用场景和适用范围

• 企业级Golang应用的生产环境容器化部署
• 需要保证开发、测试与生产环境一致性的Golang项目
• 对镜像安全性、稳定性和资源效率有较高要求的业务场景
• Golang微服务架构的容器化交付与运维
• 需要快速扩展和部署的Golang应用（如API服务、后端服务）

使用方法和配置说明

基础操作

拉取镜像

# 拉取最新版本
docker pull docker.go:latest

# 拉取特定Golang版本（例如1.21）
docker pull docker.go:1.21-alpine

运行容器示例

假设本地已编译Golang应用二进制文件 app，通过挂载方式运行：

docker run -d \
  --name golang-app \
  -v /path/to/local/app:/app \
  -p 8080:8080 \
  docker.go:latest \
  ./app

构建应用镜像示例

创建 Dockerfile 使用 docker.go 作为基础镜像构建应用：

# 指定基础镜像版本
FROM docker.go:1.21-alpine

# 设置工作目录
WORKDIR /app

# 复制依赖文件并下载依赖（利用Docker层缓存优化构建）
COPY go.mod go.sum ./
RUN go mod download

# 复制应用源代码
COPY . .

# 编译应用（禁用CGO以确保静态链接，增强兼容性）
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o myapp main.go

# 运行应用（使用非root用户）
USER 1000
CMD ["./myapp"]

构建并运行自定义应用镜像：

# 构建镜像
docker build -t my-golang-service .

# 运行容器
docker run -d --name my-service -p 8080:8080 my-golang-service

环境变量配置

高级配置

自定义运行用户

如需修改运行用户，可在 Dockerfile 中通过 USER 指令指定：

# 创建自定义用户并切换
RUN adduser -D appuser
USER appuser

健康检查配置

为容器添加健康检查（在 Dockerfile 或 docker run 中配置）：

docker run -d \
  --name golang-app \
  --health-cmd "wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1" \
  --health-interval 30s \
  --health-timeout 10s \
  --health-retries 3 \
  docker.go:latest \
  ./app

CI/CD集成示例（GitHub Actions）

在 .github/workflows/deploy.yml 中集成镜像构建与推送：

name: Deploy Golang App

on:
  push:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3
      
      - name: Build with docker.go
        uses: docker/build-push-action@v5
        with:
          context: .
          file: ./Dockerfile
          push: true
          tags: my-registry/golang-app:latest
          build-args: |
            BASE_IMAGE=docker.go:1.21-alpine