dhis2/core-canary

DHIS2 Docker镜像文档

镜像概述和主要用途

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

核心功能和特性

维护者

由https://github.com/dhis2/dhis2-core%E7%BB%B4%E6%8A%A4%E3%80%82

支持的标签

• dhis2/core：DHIS2发布版和候选发布版镜像，代表稳定版本，未来不会重新构建。
• dhis2/core-dev：最新开发版DHIS2镜像，包含master分支（标记为latest）和之前3个支持的主要版本，标签每日会多次更新。
• dhis2/core-canary：每日开发版DHIS2镜像，每日标记最后一个core-dev镜像并添加“yyyyMMdd”格式日期标签（如core-canary:latest-20230124）。
• dhis2/core-pr：用于测试https://github.com/dhis2/dhis2-core%EF%BC%88%E9%9D%9Efork%EF%BC%89PR%E7%9A%84%E9%95%9C%E5%83%8F%EF%BC%8C%E5%9B%A0fork%E4%BB%93%E5%BA%93%E6%97%A0%E6%B3%95%E8%AE%BF%E9%97%AE%E7%BB%84%E7%BB%87%E5%AF%86%E9%92%A5%E3%80%82

多架构支持

从以下版本开始提供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：https://github.com/dhis2/dhis2-core/blob/master/docker-compose.yml
2. 运行最新开发版DHIS2（含PostgreSQL）：

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

更多开发环境配置细节见https://github.com/dhis2/dhis2-core#readme%E3%80%82

使用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生产经验的用户可自行使用，但需进行充分的安全、性能和压力测试。

许可信息

软件许可信息见https://github.com/dhis2/dhis2-core/blob/master/LICENSE%E3%80%82%E9%95%9C%E5%83%8F%E5%8F%AF%E8%83%BD%E5%8C%85%E5%90%AB%E5%9F%BA%E7%A1%80%E5%8F%91%E8%A1%8C%E7%89%88%E7%BB%84%E4%BB%B6%E5%8F%8A%E4%BE%9D%E8%B5%96%EF%BC%8C%E8%BF%99%E4%BA%9B%E8%BD%AF%E4%BB%B6%E5%8F%AF%E8%83%BD%E5%85%B7%E6%9C%89%E7%8B%AC%E7%AB%8B%E8%AE%B8%E5%8F%AF%E3%80%82