colisweb/scala-ci

Scala CI工具镜像

镜像概述和主要用途

该镜像是专为持续集成(CI)环境设计的Scala开发镜像，基于官方Scala镜像构建，集成CI流程常用的构建、测试工具。旨在简化Scala项目在CI平台的自动化流程，提供开箱即用环境，减少配置复杂度，提升团队开发效率。

核心功能和特性

• 基础环境：基于官方Scala镜像，支持多版本Scala（通过标签指定版本）
• 预装工具：包含sbt、git、curl、wget、openssh-client等CI必备工具
• CI优化：针对CI环境优化性能，支持依赖缓存，减少重复下载时间
• 平台兼容：适配Jenkins、GitLab CI/CD、GitHub Actions等主流CI平台
• 轻量设计：采用精简基础镜像，平衡功能与体积，加速镜像拉取

使用场景和适用范围

• Scala项目自动化流程：实现代码提交后的自动构建、单元测试、集成测试
• 多版本验证：在CI中验证项目对不同Scala/JDK版本的兼容性
• 持续部署支持：配合CI/CD流水线完成Scala应用的自动打包与部署
• 开源项目标准化：为开源Scala项目提供统一的CI环境配置模板

使用方法和配置说明

1. 获取镜像

拉取最新版本：

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/scala-ci-tools:latest

指定Scala版本（例如2.13.8）：

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/scala-ci-tools:2.13.8

2. 基本运行命令

本地测试CI流程（执行sbt构建命令）：

bash
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/[镜像仓库地址]/scala-ci-tools:latest sbt clean compile test

• --rm：容器退出后自动清理
• -v $(pwd):/app：挂载本地项目目录到容器内工作区
• -w /app：设置工作目录为/app
• sbt clean compile test：执行标准Scala项目构建流程

3. 环境变量配置

支持通过环境变量自定义构建行为：

• SBT_OPTS：sbt运行参数（如-Xmx2G -XX:+UseG1GC设置内存）
• SCALA_VERSION：指定项目Scala版本（未指定时使用镜像内置版本）
• CI_CACHE_DIR：sbt缓存目录路径（默认/root/.sbt和/root/.ivy2）

示例：配置sbt内存参数

bash
docker run --rm -e SBT_OPTS="-Xmx2G" -v $(pwd):/app -w /app docker.xuanyuan.run/[镜像仓库地址]/scala-ci-tools:latest sbt compile

4. CI平台配置示例

GitLab CI/CD配置（.gitlab-ci.yml）

yaml
stages:
  - build
  - test

build:
  stage: build
  image: docker.xuanyuan.run/[镜像仓库地址]/scala-ci-tools:2.13.8
  script:
    - sbt clean compile
  cache:
    paths:
      - ~/.sbt
      - ~/.ivy2/cache

test:
  stage: test
  image: docker.xuanyuan.run/[镜像仓库地址]/scala-ci-tools:2.13.8
  script:
    - sbt test
  cache:
    paths:
      - ~/.sbt
      - ~/.ivy2/cache

GitHub Actions配置（.github/workflows/ci.yml）

yaml
name: Scala CI

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: docker.xuanyuan.run/[镜像仓库地址]/scala-ci-tools:2.13.8
    steps:
      - uses: actions/checkout@v4
      - name: Build and test
        run: sbt clean compile test
      - name: Cache dependencies
        uses: actions/cache@v3
        with:
          path: |
            ~/.sbt
            ~/.ivy2/cache
          key: ${{ runner.os }}-sbt-${{ hashFiles('**/build.sbt') }}

5. 高级配置

• 自定义工具：基于该镜像扩展工具链（示例Dockerfile）：

  dockerfile
  FROM docker.xuanyuan.run/[镜像仓库地址]/scala-ci-tools:latest
  RUN apt-get update && apt-get install -y maven && rm -rf /var/lib/apt/lists/*
  

• 缓存优化：在CI配置中启用sbt缓存（如上述示例），减少依赖下载时间