DHIS2 Docker镜像文档

镜像概述和主要用途

DHIS2是一个开源的基于Web的平台，主要用于健康管理信息系统（HMIS）。它支持通过Web浏览器、Android设备、Java功能手机和SMS等多种客户端进行数据捕获，提供仪表板、数据透视表、图表和GIS等数据可视化应用，具备元数据管理和配置功能，并通过RESTful Web API暴露数据模型和服务。DHIS2 Docker镜像提供了便捷的部署方式，适用于不同场景下的DHIS2应用。

核心功能和特性

维护者

由DHIS2核心团队维护。

支持的标签

• dhis2/core：DHIS2发布版和候选发布版镜像，代表稳定版本，未来不会重新构建。
• dhis2/core-dev：最新开发版DHIS2镜像，包含master分支（标记为latest）和之前3个支持的主要版本，标签每日会多次更新。
• dhis2/core-canary：每日开发版DHIS2镜像，每日标记最后一个core-dev镜像并添加“yyyyMMdd”格式日期标签（如core-canary:latest-20230124）。
• dhis2/core-pr：用于测试DHIS2核心仓库（非fork）PR的镜像，因fork仓库无法访问组织密钥。

多架构支持

从以下版本开始提供linux/amd64和linux/arm64多平台镜像：

• 2.39.1-rc
• 2.38.2.0之后的版本
• 2.37.9之后的版本

使用场景和适用范围

• 生产环境：通过dhis2/core部署稳定版DHIS2（需注意风险，详见注意事项）。
• 开发环境：使用dhis2/core-dev获取最新开发版本，进行功能开发和测试。
• 每日构建验证：dhis2/core-canary用于验证当日开发成果。
• PR测试：dhis2/core-pr用于测试核心仓库PR的代码变更。

使用方法和配置说明

使用Docker Compose

1. 获取最新docker-compose.yml：dhis2-core/docker-compose.yml
2. 运行最新开发版DHIS2（含PostgreSQL）：

   sh
   DHIS2_IMAGE=dhis2/core-dev:latest docker compose up
   

更多开发环境配置细节见dhis-core/README。

使用Docker

基本运行命令（需提前配置PostgreSQL及dhis.conf）：

sh
docker run \
    --volume $HOME/code/dhis2/core/docker/dhis.conf:/opt/dhis2/dhis.conf:ro \
    dhis2/core-dev:latest

dhis.conf需包含PostgreSQL数据库访问配置，详细Docker使用方法见Docker***文档。

配置说明

上下文路径

如需在非根路径部署，通过环境变量CATALINA_OPTS设置上下文路径：

CATALINA_OPTS: "-Dcontext.path='/dhis2'"

配置后可通过http://localhost:8080/dhis2访问DHIS2。

DHIS2_HOME

默认DHIS2_HOME为/opt/dhis2，如需使用旧版路径/DHIS2_home，设置环境变量：

DHIS2_HOME=/DHIS2_home

注意事项

不推荐直接用于生产环境。目前缺乏足够生产环境验证，无法保证“关键任务”场景稳定性。有Docker生产经验的用户可自行使用，但需进行充分的安全、性能和压力测试。

许可信息

软件许可信息见LICENSE。镜像可能包含基础发行版组件及依赖，这些软件可能具有独立许可。