blueoceans/golang

Go (golang) Docker镜像文档

镜像概述

Go（golang）Docker镜像基于官方Go语言运行时构建，集成完整开发工具链，用于简化Go应用的开发、编译与部署流程。该镜像提供多版本和架构支持，确保开发、测试与生产环境的一致性，是Go项目容器化的理想选择。

核心功能与特性

• 完整工具链：包含Go编译器（go build）、包管理（go mod）、测试工具（go test）等全套开发组件
• 多版本支持：提供不同Go版本标签（如1.21、1.22等），满足不同项目版本需求
• 轻量级选项：基于Alpine或Debian基础镜像，提供多种体积规格（如alpine标签约300MB，slim标签约800MB）
• 跨架构兼容：支持amd64、arm64等主流架构，适应不同硬件环境
• 环境隔离：容器化环境避免系统依赖冲突，简化多项目并行开发

使用场景

• 本地开发环境：快速搭建标准化Go开发环境，无需本地安装Go
• CI/CD流程：在持续集成中执行代码检查、测试与编译构建
• 生产部署：作为基础镜像构建轻量级Go应用生产容器
• 教学与实验：快速体验Go语言特性，降低入门门槛

使用方法与配置说明

基础操作

拉取镜像

bash
# 拉取最新稳定版
docker pull golang:latest

# 拉取指定版本（推荐）
docker pull golang:1.22-alpine  # 轻量级Alpine版本
docker pull golang:1.22-bullseye  # Debian Bullseye版本（完整依赖）

验证安装

bash
docker run --rm golang:1.22-alpine go version
# 输出示例：go version go1.22.0 linux/amd64

开发工作流示例

编译本地项目

bash
# 进入项目目录
cd /path/to/your/go/project

# 挂载代码并编译
docker run --rm -v "$PWD":/go/src/app -w /go/src/app golang:1.22-alpine \
  sh -c "go mod init myapp && go build -o myapp"

运行Go应用

bash
# 直接运行源码（开发模式）
docker run --rm -v "$PWD":/go/src/app -w /go/src/app golang:1.22-alpine go run main.go

# 运行编译后的二进制
docker run --rm -v "$PWD":/app -w /app alpine:3.19 ./myapp

Docker Compose配置

创建docker-compose.yml：

yaml
version: '3.8'
services:
  go-dev:
    image: golang:1.22-alpine
    volumes:
      - ./:/go/src/app  # 挂载本地代码
      - go-mod-cache:/go/pkg/mod  # 缓存依赖
    working_dir: /go/src/app
    environment:
      - GOPROXY=https://goproxy.cn  # 国内代理加速
      - GO111MODULE=on
    command: sh -c "go mod download && go run main.go"

volumes:
  go-mod-cache:  # 持久化依赖缓存

启动服务：

bash
docker-compose up

生产镜像构建（多阶段构建）

创建Dockerfile：

dockerfile
# 阶段1：编译
FROM golang:1.22-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o app .

# 阶段2：运行（仅包含二进制文件）
FROM alpine:3.19
WORKDIR /root/
COPY --from=builder /app/app .
EXPOSE 8080
CMD ["./app"]

构建并运行：

bash
docker build -t my-go-app .
docker run -p 8080:8080 my-go-app

环境变量配置

常用环境变量：

配置示例：

bash
docker run --rm -e GOPROXY=[***] golang:1.22-alpine go mod download