DHIS2 Docker镜像文档

快速参考

• 维护者：
  DHIS2核心团队

• 获取帮助：
  DHIS2实践社区 - Docker标签

支持的标签

• dhis2/core - DHIS2发布版和候选发布版镜像。这些镜像代表稳定的DHIS2版本，未来不会重新构建。

• dhis2/core-dev - 最新开发版DHIS2镜像 - 包含master分支（标记为latest）和之前3个受支持的主要版本。此仓库的镜像标签每天会被多次覆盖。

• dhis2/core-canary - 每日最新开发版DHIS2镜像。我们会标记当天最后的core-dev镜像，并添加一个"yyyyMMdd"格式的日期标签，例如core-canary:latest-20230124。

• dhis2/core-pr - 来自[***]

多架构镜像

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

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

什么是DHIS2？

DHIS2是一个开源的Web-based平台，最常用于健康管理信息系统（HMIS）。它支持通过多种客户端进行数据捕获，包括Web浏览器、Android设备、Java功能手机和SMS。DHIS2提供数据可视化应用，如仪表板、数据透视表、图表和GIS。它还支持元数据管理和配置，并通过RESTful Web API公开数据模型和服务。

如何使用此镜像

使用Docker Compose

在本地运行DHIS2最简便的方式是使用Docker Compose。

可通过以下命令运行最新开发版DHIS2（包含PostgreSQL）：

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

上述命令将启动最新开发版DHIS2及PostgreSQL数据库。

更多使用Docker Compose进行开发的详细说明，请参见dhis-core/README。

使用Docker

以下是在Docker中运行DHIS2的最基本命令：

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

此命令假设您已拥有PostgreSQL数据库，且DHIS2可通过dhis.conf中的适当设置访问该数据库。

有关运行Docker容器的更多详细信息，请参考Docker文档。

如何配置此镜像

上下文路径

若需将DHIS2部署在非根路径（/）下，可通过设置环境变量配置上下文路径：

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

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

DHIS2_HOME

以前，Docker镜像构建时将环境变量DHIS2_HOME设置为/DHIS2_home。现在默认情况下，DHIS2_HOME将回退至默认值/opt/dhis2。若需保留旧有行为，可通过设置环境变量DHIS2_HOME=/DHIS2_home实现。

注意事项

不推荐将此镜像用于生产环境。目前我们缺乏足够的实践经验，无法保证其在"关键任务"生产环境中的稳定性。这并不意味着有Docker生产环境经验的用户不能使用，但任何决定使用Docker运行DHIS2的用户需自行承担风险。若决定使用，请确保进行充分的安全、性能和压力测试。

许可证

此镜像包含的软件许可证信息请参见license。

与所有Docker镜像一样，此镜像可能包含其他软件，这些软件可能具有不同的许可证（如基础发行版中的Bash等，以及主要软件的直接或间接依赖项）。