部署
Codifier 是 Ceta 平台的 Seed-Data 配置代码的版本控制工具。
目录
架构
Codifier 是 Ceta 平台的 Seed-Data 配置代码的版本控制工具。其部署架构如图
系统要求
| 项目 | 要求 |
|---|---|
| JDK | 17+ |
| Maven | 3.8+ |
| Docker | 20.10+（Docker 部署时） |
| 内存 | 最低 2GB |
| 磁盘 | 预留 5GB+（含 Git clone 缓存） |
部署方式
方式一：Docker 部署（推荐）
# 1. 构建
mvn -s settings.xml -B clean package -DskipTests
cp target/ceta-codifier-1.0.0.jar ./ceta-codifier.jar
# 2. 构建镜像
docker build -t ceta-codifier:latest .
# 3. 运行
docker run -d \
--name ceta-codifier \
-p 8090:8090 \
-v $(pwd)/data:/app/data \
-v $(pwd)/logs:/app/logs \
-e SERVER_PORT=8090 \
-e AUTH_USERNAME=admin \
-e AUTH_PASSWORD=your-password \
-e CRYPTO_MASTER_KEY=your-master-key \
-e JWT_KEY=your-jwt-key \
--restart unless-stopped \
ceta-codifier:latest
方式二：JAR 直接运行
# 前台运行
java -Xms2g -Xmx2g -jar ceta-codifier-1.0.0.jar
# 后台运行（Linux）
nohup java -Xms2g -Xmx2g -jar ceta-codifier-1.0.0.jar > /dev/null 2>&1 &
# 指定环境变量
export SERVER_PORT=8090
export AUTH_USERNAME=admin
export AUTH_PASSWORD=your-password
java -jar ceta-codifier-1.0.0.jar
环境变量配置
基础配置
| 环境变量 | 说明 | 默认值 |
|---|---|---|
SERVER_PORT | 服务端口 | 8090 |
AUTH_ENABLED | 是否启用认证 | true |
AUTH_USERNAME | 内置管理员用户名 | admin |
AUTH_PASSWORD | 内置管理员密码 | admin123 |
JWT_KEY | JWT 签名密钥 | !@#123Bot |
JWT_EXPIRE_HOURS | JWT 过期时间（小时） | 24 |
CRYPTO_MASTER_KEY | Token 加密主密钥 | s3Ed-DaTa-M@st3r-K3y! |
日志配置
| 环境变量 | 说明 | 默认值 |
|---|---|---|
LOG_LEVEL_ROOT | 根日志级别 | INFO |
LOG_LEVEL_APP | 应用日志级别 | DEBUG |
文件上传限制
| 环境变量 | 说明 | 默认值 |
|---|---|---|
MULTIPART_MAX_FILE_SIZE | 单文件最大大小 | 100MB |
MULTIPART_MAX_REQUEST_SIZE | 请求最大大小 | 100MB |
项目配置
启动后访问 http://host:8090/codifier/ → 项目管理页面，支持在线添加/编辑/删除项目。
项目数据保存在 data/projects.json，Token 自动加密存储。
数据持久化
以下目录需要持久化（Docker 部署时挂载为 Volume）：
| 目录 | 说明 |
|---|---|
data/ | 项目配置文件 projects.json + Git 仓库本地缓存 |
logs/ | 应用日志 + commit 请求日志 |
# Docker 挂载示例
-v /opt/ceta-codifier/data:/app/data
-v /opt/ceta-codifier/logs:/app/logs