jacksonjia/golang

Ubuntu Golang (含 Glide) 镜像文档

镜像概述

本镜像基于 Ubuntu 16.04 操作系统构建，提供了一个完整的 Go 语言（Golang）开发与运行环境。镜像内预装了 Glide 包管理工具，旨在为使用早期 Go 版本或依赖 Glide 进行包管理的遗留项目提供开箱即用的构建和运行支持。

核心功能与特性

• 稳定的基础系统：基于 Ubuntu 16.04 LTS，提供稳定且兼容性良好的底层系统环境。
• 完整的 Go 环境：内置 Golang 编译器及运行时，支持 Go 代码的编译、测试与执行。
• 预装 Glide 工具：集成 Glide 依赖管理工具，方便处理使用 glide.yaml 管理依赖的旧版 Go 项目。
• 开箱即用：无需手动配置系统环境和安装基础依赖，拉取后即可直接用于 CI/CD 流水线或本地开发。

使用场景与适用范围

• 遗留项目维护：适用于尚未迁移至 Go Modules，仍使用 Glide 进行依赖管理的早期 Go 项目。
• CI/CD 构建节点：作为 Jenkins、GitLab CI 等持续集成工具中的构建基础镜像。
• 本地开发与测试：为开发者提供标准化的 Go 语言编译和测试环境，避免本地环境差异导致的问题。

环境变量与配置

镜像默认配置了 Go 语言所需的核心环境变量：

• GOROOT：Go 语言的安装目录。
• GOPATH：Go 语言的工作空间目录，通常用于存放依赖包和编译后的二进制文件。
• PATH：已将 Go 的 bin 目录和 GOPATH/bin 加入系统路径，可直接在终端执行 go 和 glide 命令。

注：在实际使用中，可根据项目需求通过 -e 参数覆盖或追加环境变量。

使用方法

1. 交互式终端运行

进入容器内部的交互式终端，进行手动的代码编译或依赖下载：

bash
docker run -it --rm \
  -v $(pwd):/go/src/myproject \
  -w /go/src/myproject \
  jacksonjia/ubuntu-golang /bin/bash

进入容器后，可执行以下命令：

bash
# 下载项目依赖
glide install

# 编译项目
go build -o myapp

2. 作为基础镜像构建 (Dockerfile)

在项目的 Dockerfile 中引用此镜像进行构建：

dockerfile
FROM jacksonjia/ubuntu-golang AS builder

WORKDIR /go/src/myproject
COPY . .

# 使用 glide 安装依赖并编译
RUN glide install && \
    go build -o /myapp

# 运行阶段（可选用更小的基础镜像）
FROM ubuntu:16.04
COPY --from=builder /myapp /myapp
CMD ["/myapp"]

3. Docker Compose 部署示例

适用于需要结合数据库或其他中间件进行本地联调的场景：

yaml
version: '3.8'

services:
  golang-app:
    image: jacksonjia/ubuntu-golang
    container_name: go_dev_env
    volumes:
      - ./:/go/src/myproject
    working_dir: /go/src/myproject
    command: >
      bash -c "glide install && go run main.go"
    ports:
      - "8080:8080"
    environment:
      - GOPROXY=https://goproxy.cn,direct
      - APP_ENV=development

注意事项

1. 版本兼容性：Ubuntu 16.04 和 Glide 均属于较早期的技术栈。对于新项目，建议使用基于较新 Ubuntu 版本并原生支持 Go Modules 的官方 Golang 镜像。
2. 网络代理：在下载 Go 依赖时，若遇到网络问题，建议在运行容器时注入 GOPROXY 环境变量（如 GOPROXY=https://goproxy.cn,direct）以加速依赖拉取。