SOFA 持续集成配置镜像

概述

SOFA 持续集成配置镜像是专为 SOFA（分布式架构中间件）项目设计的 Docker 镜像，提供预配置的持续集成环境，旨在简化 SOFA 应用及组件的 CI/CD 流程。镜像集成了 SOFA 项目开发所需的构建工具、测试框架及环境依赖，支持自动化构建、测试、打包及部署环节，降低 SOFA 项目集成流程的配置复杂度。

核心功能与特性

• 预配置构建环境：集成 Maven、Gradle 等构建工具，适配 SOFA 项目的编译需求
• 内置测试框架：包含 SOFA 测试组件（如 sofa-test）及常用测试工具，支持单元测试、集成测试
• 环境一致性：标准化 CI 环境，避免因本地环境差异导致的构建问题
• 灵活扩展：支持自定义构建脚本、测试参数及部署流程
• SOFA 组件适配：预配置与 SOFA 中间件（如 SOFARPC、SOFABoot）的集成依赖

使用场景

• SOFA 应用开发团队的日常构建与测试流程自动化
• SOFA 组件的持续集成与版本发布验证
• 多环境（开发、测试、预发）下的 SOFA 应用部署前验证
• 开源 SOFA 项目的贡献者提交代码时的自动化校验

使用方法与配置说明

基本使用（Docker Run）

通过挂载项目目录并指定构建命令启动容器：

bash
docker run -it --rm \
  -v $(pwd):/workspace \  # 挂载本地项目目录至容器工作区
  -w /workspace \         # 设置工作目录
  sofa/ci-config:latest \ # 镜像名称及标签
  mvn clean package       # 执行构建命令（如Maven打包）

环境变量配置

通过 -e 参数传递环境变量，自定义构建行为：

示例：指定 Gradle 构建并跳过测试

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  -e BUILD_TOOL=gradle \
  -e SKIP_TESTS=true \
  sofa/ci-config:latest \
  gradle build

Docker Compose 配置示例

创建 docker-compose.yml 定义服务：

yaml
version: '3'
services:
  sofa-ci:
    image: sofa/ci-config:latest
    volumes:
      - ./:/workspace
    working_dir: /workspace
    environment:
      - BUILD_TOOL=maven
      - SOFA_VERSION=3.4.6
      - TEST_SCOPE=integration
    command: mvn clean verify

启动命令：docker-compose run sofa-ci

自定义构建脚本

将自定义构建逻辑写入脚本（如 ci-script.sh），挂载至容器并执行：

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  sofa/ci-config:latest \
  sh ci-script.sh

脚本示例（ci-script.sh）：

bash
#!/bin/sh
# 编译项目
mvn clean package -DskipTests
# 执行集成测试
mvn test -P integration
# 生成测试报告
mvn surefire-report:report

注意事项

• 确保本地项目目录具有读写权限，避免容器内权限不足
• 大型项目建议挂载 Maven/Gradle 缓存目录（如 -v ~/.m2:/root/.m2）以加速构建
• 如需网络代理，可通过 ENV http_proxy 等环境变量配置代理信息