projectestac/jclic-reports

Docker容器（含Tomcat7、MariaDB及JClic Reports）

镜像概述

本Docker镜像集成了Tomcat 7、MariaDB 10.2和JClic Reports系统，可快速部署报告管理服务。镜像支持多语言切换，提供样例数据加载功能，便于用户快速体验系统功能，同时支持数据持久化、端口自定义等高级配置。

核心功能

• 运行基于Tomcat 7的JClic Reports服务
• 内置MariaDB 10.2存储报告数据
• 支持多语言（加泰罗尼亚语、西班牙语、英语）切换
• 提供样例数据加载命令
• 支持将数据库数据持久化到本地文件系统
• 可暴露MySQL端口供外部访问
• 允许自定义镜像构建以满足特定需求

使用场景

• 快速搭建JClic Reports测试环境
• 部署小型报告管理服务
• 作为开发自定义JClic Reports镜像的基础模板

配置说明

使用方法

1. 在系统上安装Docker，参考官方文档：

   • https://docs.docker.com/install/linux/docker-ce/ubuntu/
   • https://docs.docker.com/docker-for-windows/install/
   • https://docs.docker.com/docker-for-mac/install/

2. 创建并启动JClic Reports容器：

bash
docker run -d --name reports -p 8080:8080 docker.xuanyuan.run/projectestac/jclic-reports

该命令会下载镜像、创建名为"reports"的容器并启动，服务可通过http://localhost:8080/reports访问。

3. 加载样例数据（首次启动无数据时）：

bash
docker exec reports loadSampleData

常用命令

• 切换语言（将xx替换为ca/es/en）：访问http://localhost:8080/reports/main?lang=xx
• 停止容器（保留数据）：

bash
docker stop reports

• 重启容器：

bash
docker start reports

• 删除容器（丢失数据）：

bash
docker stop reports
docker rm reports
# 可选：删除镜像
docker rmi projectestac/jclic-reports

高级用法

数据持久化到本地文件系统

默认数据存储在容器内，删除容器会丢失数据。可将数据持久化到本地目录：

bash
# 停止并删除现有容器（若存在）
docker stop reports
docker rm reports
# 替换为本地真实目录
cd /my/data/directory
mkdir mysql-jclic
# 创建新容器（Windows系统将$(pwd)替换为%cd%或${PWD}）
docker run -d --name reports --mount type=bind,source=$(pwd)/mysql-jclic,target=/var/lib/mysql -p 8080:8080 docker.xuanyuan.run/projectestac/jclic-reports

暴露MySQL端口

添加-p 3306:3306参数可暴露MariaDB端口：

bash
docker run -d --name reports -p 8080:8080 -p 3306:3306 docker.xuanyuan.run/projectestac/jclic-reports

自定义镜像构建

JClic是开源系统，可自定义镜像：

1. 克隆仓库：git clone https://github.com/projectestac/jclic.git
2. 进入目录：cd jclic/dist/docker/reports
3. 编辑Dockerfile及相关文件
4. 构建镜像（替换为你的Docker用户名）：

bash
docker build -t mydockername/jclic-reports .

5. 启动自定义镜像：

bash
docker run -d --name reports -p 8080:8080 docker.xuanyuan.run/mydockername/jclic-reports