arm64v8/clojure

Clojure Docker镜像 (arm64v8) 技术文档

1. 镜像概述与主要用途

1.1 关于Clojure

Clojure是Lisp编程语言的一种方言，是一门强调函数式编程的通用编程语言。它可运行于Java虚拟机（JVM）、公共语言运行时（CLR）及JavaScript引擎。与其他Lisp语言类似，Clojure将代码视为数据，并具备宏系统。

1.2 镜像用途

本镜像为arm64v8架构提供Clojure运行环境，支持多种项目构建工具，适用于Clojure应用的开发、构建与运行。作为官方Clojure镜像的特定架构版本，它提供了一致的开发体验，同时针对arm64v8架构进行了优化。

2. 核心功能与特性

2.1 多构建工具支持

集成Clojure生态的三大主流构建工具：

• Leiningen：最成熟、应用最广泛的构建工具
• Boot：作为Leiningen的替代方案，提供灵活的构建流程
• Tools-deps：官方推出的依赖管理与构建工具

2.2 跨架构兼容性

作为多架构镜像的一部分，支持以下架构（本镜像专注于arm64v8）：

• amd64、arm64v8、ppc64le、riscv64、s390x

2.3 多样化镜像变体

提供多种镜像版本以满足不同场景需求：

• 标准变体：基于Debian系统，包含完整依赖
• Slim变体：精简版，仅保留核心运行组件
• Alpine变体：基于Alpine Linux，镜像体积最小化

3. 使用场景与适用范围

3.1 开发环境

• 快速搭建一致的Clojure开发环境，避免本地环境配置差异
• 支持依赖缓存，加速项目构建过程

3.2 应用构建

• 编译Clojure项目为独立可执行Jar包（uberjar）
• 支持CI/CD流程中的自动化构建步骤

3.3 生产部署

• 作为基础镜像构建生产环境Clojure应用容器
• 支持通过优化Dockerfile减少镜像体积和启动时间

4. 使用方法与配置说明

4.1 构建工具选择

通过镜像标签指定构建工具及版本，基础标签格式：

• arm64v8/clojure:lein：默认Leiningen版本
• arm64v8/clojure:boot：默认Boot版本
• arm64v8/clojure:tools-deps：默认Tools-deps版本
• 版本指定：添加版本号，如arm64v8/clojure:lein-2.8.1

4.2 使用Leiningen运行应用

4.2.1 基础Dockerfile示例

适用于简单项目，每次运行时下载依赖并启动：

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

构建并运行：

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

4.2.2 优化Dockerfile示例

缓存依赖以减少启动时间，预编译为独立Jar：

dockerfile
FROM arm64v8/clojure
RUN mkdir -p /usr/src/app
WORKDIR /usr/src/app
# 复制依赖文件并缓存
COPY project.clj /usr/src/app/
RUN lein deps
# 复制源代码并构建uberjar
COPY . /usr/src/app
RUN mv "$(lein uberjar | sed -n 's/^Created \(.*standalone\.jar\)/\1/p')" app-standalone.jar
CMD ["java", "-jar", "app-standalone.jar"]

4.3 编译项目为Jar包

无需编写Dockerfile，直接通过容器编译现有项目：

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

编译结果位于项目的target/uberjar目录。

4.4 Boot与Tools-deps使用

关于使用Boot和Tools-deps构建工具的详细说明，请参考https://github.com/Quantisan/docker-clojure/blob/master/README.md%E3%80%82

5. 镜像变体详情

5.1 标准变体 (arm64v8/clojure:<version>)

• 基于Debian系统（如bookworm、bullseye等版本）
• 包含完整的系统工具和依赖库
• 适用场景：开发环境、需要额外系统工具的构建流程

5.2 Slim变体 (arm64v8/clojure:<version>-slim)

• 基于Debian Slim镜像，仅保留核心运行依赖
• 体积小于标准变体，启动速度更快
• 适用场景：对镜像体积有要求，但依赖glibc的环境

5.3 Alpine变体 (arm64v8/clojure:<version>-alpine)

• 基于Alpine Linux，体积最小（基础镜像约5MB）
• 使用musl libc替代glibc，可能存在兼容性限制
• 适用场景：极致追求镜像体积，且无复杂libc依赖的应用

6. 支持的标签

完整标签列表请参考https://github.com/docker-library/docs/tree/master/clojure/README.md#supported-tags-and-respective-dockerfile-links%E3%80%82%E6%A0%87%E7%AD%BE%E5%91%BD%E5%90%8D%E8%A7%84%E5%88%99%EF%BC%9A

• 按构建工具分类：lein、boot、tools-deps
• 按基础系统分类：默认（Debian）、-slim、-alpine
• 版本指定：工具版本（如lein-2.9.10）、Clojure版本、系统版本（如-bookworm）

7. 维护与支持

• 维护者：Docker社区 (https://github.com/Quantisan/docker-clojure)
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux Stack Exchange
• 问题反馈：https://github.com/Quantisan/docker-clojure/issues
• 镜像更新：通过https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fclojure%E8%B7%9F%E8%B8%AA%E6%9B%B4%E6%96%B0

8. 许可证信息

• Clojure软件许可证：查看官方许可信息
• 镜像包含软件：可能包含其他开源软件（如Bash、基础系统组件等），其许可证需单独确认
• 镜像元数据：https://github.com/docker-library/repo-info/tree/master/repos/clojure%E6%8F%90%E4%BE%9B%E8%87%AA%E5%8A%A8%E6%A3%80%E6%B5%8B%E7%9A%84%E8%AE%B8%E5%8F%AF%E8%AF%81%E4%BF%A1%E6%81%AF

使用本镜像即表示您同意遵守所有包含软件的相关许可条款。