Clojure Docker镜像文档

镜像概述和主要用途

Clojure是Lisp编程语言的一种方言，是一种强调函数式编程的通用编程语言，运行在Java虚拟机（JVM）、公共语言运行时（CLR）和JavaScript引擎上。与其他Lisp语言一样，Clojure将代码视为数据，并具有宏系统。

本Docker镜像提供了Clojure的容器化环境，支持多种构建工具，可用于快速开发、构建和运行Clojure项目，也可作为构建其他基于Clojure的应用镜像的基础。

核心功能和特性

• 多构建工具支持：兼容Leiningen（最常用的Clojure构建工具）、Boot（替代Leiningen的构建工具）和tools-deps（官方推出的依赖管理工具）
• 多架构支持：包括amd64、arm64v8、ppc64le、riscv64、s390x等架构
• 灵活的标签策略：可指定构建工具版本（如clojure:lein-2.8.1），也可使用默认标签（如clojure:lein）
• 多种镜像变体：提供默认版、alpine版（基于Alpine Linux，体积更小）和slim版（最小化依赖）

使用场景和适用范围

• Clojure项目的开发环境搭建
• Clojure应用的容器化构建与部署
• CI/CD流程中集成Clojure项目的自动化构建和测试
• 快速原型开发和临时运行Clojure代码

详细使用方法和配置说明

支持的标签

注意：本镜像描述长度超过Docker Hub的25000字符限制，因此"支持的标签"列表已被截断。详情请参见GitHub文档。

构建工具选择

Clojure有三种主要的项目构建和运行方式：

1. Leiningen：最古老且最常用的工具，标签格式为clojure:lein或clojure:lein-<version>（如clojure:lein-2.8.1）
2. Boot：Leiningen的替代方案，标签格式为clojure:boot或clojure:boot-<version>
3. tools-deps：官方推出的依赖管理工具，标签格式为clojure:tools-deps或clojure:tools-deps-<version>

使用Leiningen运行应用

基础Dockerfile示例

为现有Leiningen/Clojure项目添加以下Dockerfile：

FROM clojure
COPY . /usr/src/app
WORKDIR /usr/src/app
CMD ["lein", "run"]

构建并运行镜像：

$ docker build -t my-clojure-app .
$ docker run -it --rm --name my-running-app my-clojure-app

优化版Dockerfile（预下载依赖和编译）

上述基础示例每次运行都会下载依赖、编译项目，启动较慢。优化版预下载依赖并编译为独立JAR：

FROM clojure
RUN mkdir -p /usr/src/app
WORKDIR /usr/src/app
COPY project.clj /usr/src/app/
RUN lein deps  # 下载依赖（依赖变更时才会重新下载）
COPY . /usr/src/app
RUN mv "$(lein uberjar | sed -n 's/^Created \(.*standalone\.jar\)/\1/p')" app-standalone.jar  # 编译为独立JAR
CMD ["java", "-jar", "app-standalone.jar"]

同样使用上述docker build和docker run命令构建运行。

在容器内编译Lein/Clojure项目为JAR

对于现有Lein/Clojure项目，可直接在容器内编译为JAR：

$ docker run -it --rm -v "$PWD":/usr/src/app -w /usr/src/app clojure lein uberjar

编译后的JAR文件位于项目的target/uberjar目录。

Boot和tools-deps的使用

有关使用Boot和tools-deps的详细说明，请参见官方镜像README。

镜像变体

Clojure镜像提供多种变体，适用于不同场景：

clojure:<version>（默认镜像）

这是默认镜像，适用于大多数场景。既可作为临时容器（挂载源码并启动应用），也可作为构建其他镜像的基础。部分标签包含Debian或Ubuntu发行版代号（如bookworm、bullseye、jammy），表示基于相应的发行版构建，适合需要安装额外包的场景。

clojure:<version>-alpine

基于Alpine Linux的镜像，体积更小（约5MB基础镜像）。主要适用于对镜像大小有严格要求的场景。注意：Alpine使用musl libc而非glibc，可能与某些依赖glibc的软件不兼容。通常不包含git、bash等额外工具，需在Dockerfile中自行安装。

clojure:<version>-slim

精简版镜像，仅包含运行Clojure所需的最小依赖。仅推荐在空间受限且仅部署Clojure镜像的环境中使用，否则建议使用默认镜像。

许可证信息

• 本镜像包含的软件许可证信息请参见Clojure官方许可证页面。
• 与所有Docker镜像一样，本镜像可能包含其他软件（如基础发行版的Bash等），这些软件可能具有其他许可证。
• 自动检测的额外许可证信息可在repo-info仓库的clojure/目录中找到。
• 使用预构建镜像时，用户有责任确保其使用符合所有包含软件的相关许可证要求。

维护与支持

• 维护者：Docker社区
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux Stack Exchange或Stack Overflow
• 提交issue：[***]
• 镜像更新：通过official-images repo的library/clojure标签跟踪更新