dhis2/core

DHIS2 Docker镜像文档

快速参考

• 维护者：
  https://github.com/dhis2/dhis2-core

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

支持的标签

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

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

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

• https://hub.docker.com/r/dhis2/core-pr - 来自https://github.com/dhis2/dhis2-core%EF%BC%88%E9%9D%9E%E5%88%86%E6%94%AF%E4%BB%93%E5%BA%93%EF%BC%89%E7%9A%84PR%E7%89%88%E6%9C%AC%E9%95%9C%E5%83%8F%E3%80%82%E5%88%86%E6%94%AF%E4%BB%93%E5%BA%93%E6%97%A0%E6%B3%95%E8%AE%BF%E9%97%AE%E7%BB%84%E7%BB%87/%E4%BB%93%E5%BA%93%E5%AF%86%E9%92%A5%EF%BC%8C%E5%9B%A0%E6%AD%A4%E4%B8%8D%E5%8C%85%E5%90%AB%E5%9C%A8%E5%86%85%E3%80%82

多架构镜像

从以下版本开始提供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进行开发的详细说明，请参见https://github.com/dhis2/dhis2-core#readme%E3%80%82

使用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

https://github.com/dhis2/dhis2-core/blob/b4d4242fb30d974254de2a72b86cc5511f70c9c0/docker/tomcat-debian/Dockerfile#L9%EF%BC%8CDocker%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%E6%97%B6%E5%B0%86%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%60DHIS2_HOME%60%E8%AE%BE%E7%BD%AE%E4%B8%BA%60/DHIS2_home%60%E3%80%82%E7%8E%B0%E5%9C%A8%E9%BB%98%E8%AE%A4%E6%83%85%E5%86%B5%E4%B8%8B%EF%BC%8C%60DHIS2_HOME%60%E5%B0%86https://github.com/dhis2/dhis2-core/blob/b4d4242fb30d974254de2a72b86cc5511f70c9c0/dhis-2/dhis-support/dhis-support-external/src/main/java/org/hisp/dhis/external/location/DefaultLocationManager.java#L58%60/opt/dhis2%60%E3%80%82%E8%8B%A5%E9%9C%80%E4%BF%9D%E7%95%99%E6%97%A7%E6%9C%89%E8%A1%8C%E4%B8%BA%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E8%AE%BE%E7%BD%AE%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%60DHIS2_HOME=/DHIS2_home%60%E5%AE%9E%E7%8E%B0%E3%80%82

注意事项

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

许可证

此镜像包含的软件许可证信息请参见https://github.com/dhis2/dhis2-core/blob/master/LICENSE%E3%80%82

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