bloxroute/circleci-go-node

镜像概述

本镜像为持续集成(CI)专用镜像，基于cimg/go基础镜像构建，在保留Golang开发环境的同时，额外集成了Node.js运行时及相关依赖。旨在为需要同时处理Go后端代码和Node.js前端/工具链的项目提供统一的CI环境，简化多语言项目的构建、测试流程。

核心功能与特性

• 双语言环境集成：同时包含Golang和Node.js运行时，满足多语言项目开发需求
• 基于cimg/go：继承cimg/go镜像的Golang环境配置，包括Go编译器、标准库及常用工具
• CI优化：预配置CI流程所需基础依赖，可直接用于代码构建、单元测试、静态分析等环节
• 版本兼容性：遵循cimg/go的版本管理策略，确保Golang版本稳定，同时集成兼容的Node.js版本

使用场景与适用范围

• 同时包含Go后端和Node.js前端的全栈应用项目
• 需要使用Node.js工具链（如Webpack、Babel等）构建资源的Go项目
• 依赖Golang和Node.js双环境的自动化测试、代码质量检查流程
• 多语言组件的持续集成与持续部署(CI/CD)流水线

使用方法与配置说明

基本使用

通过docker run命令启动容器，可直接使用Golang和Node.js环境：

bash
docker run --rm -it cimg/go-node-ci:latest sh

进入容器后，可验证环境版本：

bash
# 检查Golang版本
go version

# 检查Node.js版本
node -v

# 检查npm版本
npm -v

在CI流程中使用

以GitHub Actions为例，在工作流文件中使用该镜像：

yaml
jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: cimg/go-node-ci:latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Build Go project
        run: go build -o app ./cmd/main.go
      
      - name: Install Node.js dependencies
        run: npm install
      
      - name: Build frontend assets
        run: npm run build

环境变量

本镜像继承cimg/go的环境变量，同时支持Node.js相关环境变量配置，常用变量包括：

• GOPATH：Go工作目录，默认/home/circleci/go
• NODE_ENV：Node.js环境类型，可设置为production、development等
• NPM_CONFIG_PREFIX：npm全局安装路径，默认/home/circleci/.npm-global

自定义配置

如需扩展镜像功能，可基于本镜像创建Dockerfile：

dockerfile
FROM cimg/go-node-ci:latest

# 安装额外依赖
RUN sudo apt-get update && sudo apt-get install -y some-package

# 配置自定义npm镜像
RUN npm config set registry https://registry.npm.taobao.org

构建并使用自定义镜像：

bash
docker build -t custom-go-node-ci .
docker run --rm -it custom-go-node-ci sh