tozny/golang

docker-go 镜像文档

镜像概述

docker-go是一个基于Alpine Linux 3.18构建的Go 1.21稳定版Docker容器，旨在为Go应用程序提供轻量级、可靠的运行和开发环境。该镜像整合了Alpine Linux的轻量级特性与Go 1.21的功能，适合从开发到生产环境的全流程使用。

核心功能与特性

• 轻量级基础：基于Alpine Linux 3.18，镜像体积小，资源占用低，适合高效部署。
• 稳定版本：内置Go 1.21稳定版，确保开发和运行环境的一致性。
• 兼容性：支持标准Go工具链（如go build、go run、go test等），兼容大多数Go应用开发流程。

使用场景

• 开发环境：本地Go应用开发、调试，无需在主机直接安装Go环境。
• CI/CD流程：作为持续集成/部署中的构建或测试环境，确保环境一致性。
• 生产部署：轻量级容器适合资源受限场景下的Go应用运行。

使用方法

基本运行

通过以下命令启动容器并进入交互式终端：

bash
docker run -it --rm docker.xuanyuan.run/docker-go:latest sh

• -it：启用交互式终端。
• --rm：容器退出后自动删除，避免残留。
• sh：启动Alpine默认shell。

开发与构建

挂载本地Go项目目录到容器中，进行代码编译或运行：

bash
# 运行Go程序
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/docker-go:latest go run main.go

# 构建可执行文件
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/docker-go:latest go build -o myapp main.go

• -v $(pwd):/app：将当前目录挂载到容器内/app目录。
• -w /app：设置工作目录为/app，即项目根目录。
• go run/main.go：执行Go程序；go build：编译生成可执行文件。

自定义配置

可通过环境变量或挂载配置文件调整行为（如设置GOPROXY加速依赖下载）：

bash
docker run --rm -e GOPROXY=https://goproxy.cn -v $(pwd):/app -w /app docker.xuanyuan.run/docker-go:latest go mod download

• -e GOPROXY=https://goproxy.cn：设置Go模块代理，加速依赖拉取。

生产部署

构建完成后，可将生成的可执行文件复制到更精简的Alpine镜像中运行，或直接使用本镜像运行编译产物：

bash
# 运行编译后的可执行文件
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/docker-go:latest ./myapp