alexfalkowski/go

Go Docker镜像文档

概述

该镜像为Go语言开发和应用部署提供基础环境，基于轻量级操作系统（通常为Alpine或Debian）构建，包含完整的Go SDK（Software Development Kit），包括编译器、包管理工具、调试工具等组件。适用于Go应用的开发调试、自动化构建及生产环境部署。

核心功能与特性

• 完整开发环境：内置Go编译器（go build）、包管理器（go mod）、测试工具（go test）及代码格式化工具（go fmt）
• 轻量级设计：提供多种变体（如alpine、slim），最小化镜像体积，降低资源占用
• 多阶段构建支持：可作为构建阶段基础镜像，配合运行时镜像（如alpine）实现精简部署
• 跨平台兼容性：支持多种CPU架构（amd64、arm64、ppc64le等），满足不同硬件环境需求
• 版本化管理：提供多版本标签（如1.21、1.20、latest），便于锁定开发环境版本

使用场景

• 本地开发调试：快速搭建一致的Go开发环境，避免系统依赖冲突
• CI/CD流程集成：在自动化流水线中执行代码检查、编译构建和单元测试
• 生产环境部署：通过多阶段构建生成轻量级运行时镜像，部署Go应用程序
• 跨平台应用构建：利用Docker的跨平台构建能力，为不同架构编译Go二进制文件

使用方法

基本使用

验证Go环境

通过以下命令检查Go版本及环境配置：

bash
docker run --rm golang:latest go version
docker run --rm golang:latest go env

交互式开发

启动交互式终端，直接在容器内编写和测试代码：

bash
docker run -it --rm golang:latest sh
# 在容器内执行
go mod init example/hello
echo 'package main; import "fmt"; func main() { fmt.Println("Hello, Docker!") }' > main.go
go run main.go  # 输出: Hello, Docker!

本地代码挂载与编译

将本地Go项目挂载到容器中进行编译：

bash
# 假设本地项目路径为/path/to/your/project
docker run --rm -v /path/to/your/project:/go/src/app -w /go/src/app golang:latest go build -o app

编译产物app将生成在本地项目目录中。

多阶段构建示例

通过多阶段构建分离编译环境与运行环境，生成最小化部署镜像：

dockerfile
# 阶段1: 编译应用
FROM golang:1.21-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 myapp .  # 构建静态链接二进制

# 阶段2: 运行环境
FROM alpine:3.18
RUN apk --no-cache add ca-certificates  # 添加必要证书
WORKDIR /root/
COPY --from=builder /app/myapp .  # 从构建阶段复制二进制文件
CMD ["./myapp"]

Docker Compose配置示例

创建docker-compose.yml用于本地开发环境：

yaml
version: '3.8'
services:
  go-dev:
    image: golang:1.21-alpine
    volumes:
      - ./:/go/src/app  # 挂载本地代码
      - go-mod-cache:/go/pkg/mod  # 持久化依赖缓存
    working_dir: /go/src/app
    command: sh -c "go run main.go"
    environment:
      - GOPATH=/go
      - GO111MODULE=on
      - CGO_ENABLED=1

volumes:
  go-mod-cache:  # 缓存Go模块，加速依赖下载

启动服务：

bash
docker-compose up

配置参数

常用环境变量

镜像标签说明

注：具体标签及版本信息可参考https://hub.docker.com/_/golang%E3%80%82