企业官网建设流程全解析

Luminus-template 部署实战：uberjar 打包与 Docker 容器化完整教程

【免费下载链接】luminus-templatea template project for the Luminus framework项目地址: https://gitcode.com/gh_mirrors/lu/luminus-template

想要把 Clojure Web 应用快速部署上线？Luminus-template 正是为此而生的 Leiningen 项目模板，它能在几十秒内生成一个结构完整、开箱即用的 Luminus Web 应用，随后通过lein uberjar一键打包成可执行 JAR，再借助 Docker 容器化实现一次构建、到处运行。本文是一份面向初学者的 Luminus-template 部署实战教程，带你走完从创建项目到 Docker 容器化部署的全过程。

Luminus-template 是什么？为什么用它部署 Clojure 应用

Luminus-template 是 Luminus 框架官方维护的 Leiningen 模板，它不只是生成一堆骨架代码，而是自带完整的配置体系：开发/生产/测试三套环境配置、默认的 Undertow 服务器、日志系统、路由中间件，甚至还有现成的 Dockerfile 和 Procfile。

这意味着什么？你不需要从零搭建项目结构，模板已经把所有"搬砖"的部分做好，你只需专注业务代码，部署环节更是有现成方案可循。对新手来说，这是上手 Clojure Web 开发并快速部署的最低成本路径。

部署前准备：环境与依赖清单

开始之前，请确认你的机器满足以下条件：

其中 Leiningen 是 Clojure 世界的"Maven+Gradle"，也是本文一切操作的基础。若尚未安装，请先安装并执行lein version验证，模板对 Leiningen 版本有硬性校验，过低版本会直接提示升级（可参考 luminus.clj 中的版本检查逻辑）。

第一步：用 Luminus-template 创建 Clojure Web 项目

创建项目只需一条命令：

lein new luminus myapp

其中myapp是你的项目名。如果你想扩展功能，Luminus-template 还提供了大量 profile 选项，例如：

lein new luminus myapp +postgres +auth +swagger

一个命令就能同时接入 PostgreSQL 数据库、认证机制和 Swagger API 文档，这些 profile 的实现都集中在 src/leiningen/new/ 目录下，如数据库相关的 db.clj、认证相关的 auth.clj。生成的项目会包含project.clj、Dockerfile、Procfile、三套环境配置等完整文件，直接可用。

第二步：uberjar 打包的最快配置方法

进入项目目录，执行打包命令：

cd myapp lein uberjar

这条命令会解析project.clj中的依赖（模板已为你配好 Clojure、Ring、Selmer 等核心依赖，详见 project.clj 的依赖管理逻辑），下载依赖后编译并打包出独立可执行的 uberjar——它把应用代码、所有第三方库和资源文件全部塞进一个 JAR 里，这也是它叫"uber（超级）jar"的原因。

打包成功后，产物位于target/uberjar/myapp.jar。这一步是后续一切部署方式的基础，也是 Luminus 应用部署最核心的一环。

第三步：java -jar 运行与验证

无需任何额外配置，直接运行：

java -jar target/uberjar/myapp.jar

看到server started on port: 3000之类的日志，说明应用已经启动，此时用浏览器访问http://localhost:3000即可看到应用首页。默认端口是 3000，生产环境可通过环境变量或config.edn覆盖端口配置（模板在 env/prod/resources/config.edn 提供了生产环境配置模板）。

第四步：Docker 容器化部署完整步骤

Luminus-template 贴心地为你准备了现成的 Dockerfile（见 core/Dockerfile），容器化部署只需三步：

1. 编写 Dockerfile

基于模板生成的项目自带 Dockerfile，核心内容如下：

FROM openjdk:8-alpine COPY target/uberjar/myapp.jar /myapp/app.jar EXPOSE 3000 CMD ["java", "-jar", "/myapp/app.jar"]

2. 构建镜像

docker build -t myapp:latest .

3. 运行容器

docker run -p 3000:3000 myapp:latest

此时访问http://localhost:3000，你的应用已经在容器里跑起来了！配合-d参数可后台运行，配合-e参数可注入环境变量配置。

Dockerfile 关键配置解读

模板的 Dockerfile 虽然只有几行，但每行都值得理解：

• 基础镜像：基于轻量级openjdk:8-alpine，体积小、启动快，适合生产环境
• COPY 指令：把打包好的 uberjar 复制进容器，因为 uberjar 自带全部依赖，镜像里无需再装 Clojure 环境
• EXPOSE 3000：声明容器对外暴露的端口，与 Luminus 应用默认端口一致
• CMD 指令：容器启动时执行java -jar，与应用本地运行方式完全一致

这种"打包即部署"的模式，正是 uberjar + Docker 组合的最大优势：开发环境、测试环境、生产环境运行的是同一个产物，彻底告别"在我电脑上能跑"的尴尬。

进阶技巧与常见问题

🚀 进阶技巧

• 多环境配置：利用 config.clj 模板，通过环境变量切换开发/生产配置，容器部署时用docker run -e注入即可
• 结合 Procfile：模板自带 Procfile，可配合 Heroku 等 PaaS 平台直接部署，无需自己写启动命令
• 多 profile 组合：打包前确认project.clj中已声明所有需要的依赖，缺依赖时在创建项目阶段用 profile 补齐最省事

⚠️ 常见问题

总结

从lein new luminus创建项目，到lein uberjar打包，再到docker build+docker run容器化部署，Luminus-template 让 Clojure Web 应用的部署链路变得异常简单。模板提供的现成 Dockerfile 和 Procfile，让新手也能在半小时内完成从零到上线的完整流程。下次需要快速交付一个 Clojure 应用，不妨直接用它试试！

【免费下载链接】luminus-templatea template project for the Luminus framework项目地址: https://gitcode.com/gh_mirrors/lu/luminus-template