implustechnology/golang-compile

golang-compile 镜像文档

镜像概述和主要用途

golang-compile 是一个集成了多种开发工具的Docker镜像，旨在为Go语言项目提供完整的编译和开发环境。该镜像包含Go语言运行时环境、Glide包管理工具、Bash shell、Docker客户端、Git版本控制工具以及OpenSSH客户端，可满足Go项目从代码拉取、依赖管理到编译构建的全流程需求。

核心功能和特性

• Go语言环境：内置Go编译器和运行时，支持Go项目的编译和运行
• Glide包管理：集成Go语言依赖管理工具Glide，方便项目依赖的安装和管理
• Bash shell：提供Bash环境，支持复杂的脚本执行和命令操作
• Docker客户端：包含Docker命令行工具，可在容器内与Docker守护进程交互，支持镜像构建等操作
• Git版本控制：集成Git工具，支持代码仓库克隆、提交、分支管理等版本控制操作
• OpenSSH客户端：提供SSH客户端功能，支持通过SSH协议访问远程服务器或代码仓库

使用场景和适用范围

• CI/CD流程：作为持续集成/持续部署流程中的构建环境，用于自动拉取代码、安装依赖并编译Go项目
• 本地开发环境：为开发者提供一致的Go开发环境，避免因本地环境差异导致的问题
• 跨平台编译：支持在不同操作系统环境下构建Go项目，提高开发效率
• 自动化脚本执行：结合Bash和其他工具，实现Go项目的自动化构建和部署流程

使用方法和配置说明

基本使用

通过以下命令启动容器：

bash
docker run -it --rm golang-compile bash

该命令将以交互模式启动容器，并进入Bash shell。

挂载项目目录

如需编译本地Go项目，可将项目目录挂载到容器内：

bash
docker run -it --rm -v /path/to/your/go/project:/go/src/app golang-compile bash

环境变量配置

可通过环境变量配置Go相关参数，常用环境变量包括：

• GOPATH：Go工作目录，默认为/go
• GOBIN：Go可执行文件输出目录，默认为$GOPATH/bin
• GO111MODULE：Go模块支持开关，可设置为on或off

示例：

bash
docker run -it --rm -e GOPATH=/go -e GO111MODULE=on golang-compile bash

典型操作示例

1. 克隆代码仓库：

   bash
   git clone git@github.com:yourusername/yourproject.git /go/src/app
   

2. 安装项目依赖（使用Glide）：

   bash
   cd /go/src/app
   glide install
   

3. 编译Go项目：

   bash
   go build -o app main.go
   

4. 使用Docker客户端构建镜像（需挂载Docker套接字）：

   bash
   docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock golang-compile bash
   # 在容器内执行
   docker build -t your-app .
   

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  golang-compile:
    image: golang-compile
    volumes:
      - ./your-go-project:/go/src/app
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - GOPATH=/go
      - GO111MODULE=on
    command: bash -c "cd /go/src/app && glide install && go build -o app main.go"

通过以下命令启动：

bash
docker-compose up