strategicblue/cljs-builder

镜像概述

该Docker镜像是专为ClojureScript开发设计的构建环境，集成了shadow-cljs工具链，旨在简化ClojureScript项目的编译、打包和开发流程。通过容器化方式，无需在本地配置JDK、Clojure或shadow-cljs依赖，即可快速搭建一致的ClojureScript构建环境。

核心功能

• 集成shadow-cljs工具：内置shadow-cljs构建工具，支持ClojureScript到JavaScript的编译、代码优化和模块打包
• 开发模式支持：提供热重载（hot-reload）功能，实时监控文件变化并自动重新编译，加速开发迭代
• 多目标构建：支持浏览器、Node.js等多种运行环境的构建目标，满足不同场景需求
• 完整依赖环境：包含Java运行时和Clojure环境，确保shadow-cljs正常运行所需的底层依赖

使用场景

• 本地开发环境搭建：快速初始化ClojureScript项目开发环境，避免本地依赖冲突
• CI/CD流程集成：作为自动化构建环节的基础镜像，实现ClojureScript项目的持续集成和部署
• 团队协作标准化：统一团队开发和构建工具版本，消除"在我电脑上能运行"的环境差异问题
• 生产环境打包：执行优化编译，生成用于生产环境的最小化、高性能JavaScript代码

使用方法

基本使用流程

1. 确保本地已安装Docker
2. 将ClojureScript项目目录挂载到容器内
3. 执行shadow-cljs命令进行开发或构建

常用命令示例

开发模式（热重载）

启动开发模式并监听项目文件变化，修改后自动重新编译：

bash
docker run -it --rm \
  -v $(pwd):/app \          # 挂载本地项目目录到容器/app路径
  -w /app \                 # 设置工作目录为/app
  -p 9630:9630 \            # 映射shadow-cljs仪表盘端口（可选）
  [镜像名称] \              # 替换为实际镜像名称
  shadow-cljs watch app     # "app"为项目中定义的构建目标（需在shadow-cljs.edn中配置）

执行后，通过http://localhost:9630可访问shadow-cljs仪表盘，查看构建状态和编译日志。

生产环境构建

执行优化编译，生成用于生产环境的代码（压缩、混淆、Tree-shaking）：

bash
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像名称] \
  shadow-cljs release app   # "app"为构建目标

编译产物默认输出到项目的public/js目录（具体路径由shadow-cljs.edn配置定义）。

查看帮助信息

获取shadow-cljs命令列表和参数说明：

bash
docker run --rm [镜像名称] shadow-cljs help

持久化依赖缓存

为避免每次启动容器时重复下载依赖，可通过Docker卷持久化shadow-cljs缓存目录：

bash
# 创建持久化卷（首次使用时执行）
docker volume create shadow-cljs-cache

# 使用卷启动容器
docker run -it --rm \
  -v $(pwd):/app \
  -v shadow-cljs-cache:/root/.shadow-cljs \  # 持久化缓存目录
  -w /app \
  [镜像名称] \
  shadow-cljs watch app

环境变量配置

自定义Java内存配置示例

bash
docker run -it --rm \
  -e JAVA_OPTS="-Xmx1g" \    # 调整Java堆内存为1GB
  -v $(pwd):/app \
  -w /app \
  [镜像名称] \
  shadow-cljs release app

项目配置要求

使用该镜像前，项目根目录需包含有效的shadow-cljs.edn配置文件，定义构建目标和编译选项。基础配置示例：

clojure
{:source-paths ["src"]
 :dependencies []
 :builds {:app {:target :browser
                :output-dir "public/js"
                :asset-path "/js"
                :modules {:main {:init-fn my.app/init}}}}}