cbills/build-runner

build-runner 镜像文档

镜像概述

build-runner 是一个专为 GitLab Runner 设计的 Docker 镜像，预集成了多种开发、构建和部署工具，旨在简化 CI/CD 流程中的环境配置，提供一致且高效的构建环境。

核心功能与特性

预安装工具集

• gcloud：Google Cloud 命令行工具，支持云资源管理、应用部署等云操作
• nodejs：JavaScript 运行时环境，适用于前端项目构建和 Node.js 应用开发
• bazelisk：Bazel 构建工具的版本管理器，自动处理 Bazel 版本依赖
• terraform：基础设施即代码（IaC）工具，用于云基础设施的定义和部署

使用场景与适用范围

• GitLab CI/CD 流水线：作为 Runner 执行环境，支持包含云资源操作、前端构建、Bazel 项目编译、基础设施部署等任务的自动化流程
• 多工具协同场景：适用于需要同时使用云服务管理、JavaScript 开发、构建工具和基础设施编排的项目

使用方法与配置说明

基础使用（Docker Run）

直接启动容器并进入交互式终端：

bash
docker run -it --rm docker.xuanyuan.run/build-runner /bin/bash

GitLab CI 集成

在 .gitlab-ci.yml 中配置使用该镜像：

yaml
stages:
  - build
  - deploy

build-stage:
  stage: build
  image: docker.xuanyuan.run/build-runner
  script:
    - node -v  # 验证 Node.js 环境
    - bazelisk version  # 验证 Bazelisk
    - npm install  # 安装项目依赖
    - bazelisk build //src:app  # 执行 Bazel 构建

deploy-stage:
  stage: deploy
  image: docker.xuanyuan.run/build-runner
  script:
    - gcloud auth activate-service-account --key-file=$GOOGLE_CREDENTIALS
    - terraform init
    - terraform apply -auto-approve
  only:
    - main

配置说明

• 工具版本：镜像中工具版本由镜像维护者预配置，如需特定版本需通过 Dockerfile 自定义构建
• 认证配置：gcloud、terraform 等工具需通过环境变量（如 GOOGLE_CREDENTIALS）或挂载配置文件提供认证信息
• 数据持久化：可通过 -v 参数挂载本地目录，实现构建缓存或配置文件共享