droit/clj-runner

Clojure/ClojureScript GitHub Actions运行器镜像

镜像概述

本Docker镜像专为GitHub Actions工作流设计，提供完整的Clojure和ClojureScript运行环境，旨在简化Clojure生态项目在GitHub CI/CD流程中的集成。镜像基于官方Clojure基础镜像构建，预配置了与GitHub Actions无缝协作所需的依赖组件，支持直接在工作流中执行Clojure相关任务，无需额外环境配置。

核心功能与特性

• 双语言支持：同时提供Clojure和ClojureScript运行环境，满足JVM和JavaScript目标平台的项目需求
• GitHub Actions集成：优化镜像结构以适配GitHub Actions工作流上下文，支持工作流命令、环境变量注入及成果物输出
• 工具链完整：内置Clojure CLI、Leiningen、Boot等主流构建工具，支持多种项目管理方式
• 轻量级设计：基于Alpine或 slim 基础镜像构建，减少镜像体积，提升工作流执行效率
• 版本灵活性：支持通过环境变量指定Clojure、ClojureScript及构建工具版本，适配不同项目需求

使用场景

• 在GitHub Actions工作流中执行Clojure项目的单元测试、集成测试及性能测试
• 构建Clojure应用程序JAR包或ClojureScript前端资源
• 自动化执行代码质量检查（如clj-kondo静态分析、cljfmt代码格式化）
• 部署Clojure应用至云平台（如AWS、GCP、Azure）或容器编排系统（如Kubernetes）
• 生成Clojure文档（如Codox、Marginalia）并发布至GitHub Pages

使用方法与配置说明

基础使用（Docker命令行）

本地测试或非GitHub环境中使用：

bash
# 挂载项目目录并执行Clojure测试
docker run --rm \
  -v $(pwd):/github/workspace \
  -w /github/workspace \
  clojure-github-actions-runner \
  clojure -M:test

# 使用Leiningen构建项目
docker run --rm \
  -v $(pwd):/github/workspace \
  -w /github/workspace \
  clojure-github-actions-runner \
  lein uberjar

GitHub Actions工作流配置示例

在.github/workflows/clojure-ci.yml中配置工作流：

yaml
name: Clojure CI

on: [push, pull_request]

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Run Clojure tests
        uses: docker://clojure-github-actions-runner:latest
        with:
          args: clojure -M:test:coverage

      - name: Build application
        uses: docker://clojure-github-actions-runner:latest
        with:
          args: lein uberjar

      - name: Upload build artifact
        uses: actions/upload-artifact@v3
        with:
          name: app-jar
          path: target/uberjar/*.jar

环境变量配置

高级配置示例

指定工具版本并执行多步骤任务：

yaml
steps:
  - name: Checkout code
    uses: actions/checkout@v4

  - name: Run with custom tool versions
    uses: docker://clojure-github-actions-runner:latest
    env:
      CLOJURE_VERSION: "1.10.3"
      LEIN_VERSION: "2.9.8"
    with:
      args: |
        lein deps && \
        clojure -M:lint && \
        lein test && \
        lein uberjar