openmrs/openmrs-reference-application-distro

OpenMRS参考应用Docker镜像

镜像概述

该镜像为OpenMRS参考应用的Docker分发版本，仓库已迁移至：https://hub.docker.com/r/openmrs/openmrs-reference-application%E3%80%82%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8EOpenMRS%E6%B5%8B%E8%AF%95%E7%8E%AF%E5%A2%83%E9%83%A8%E7%BD%B2%EF%BC%8C%E6%8F%90%E4%BE%9B%E6%A0%87%E5%87%86%E5%8C%96%E7%9A%84%E5%BA%94%E7%94%A8%E5%88%86%E5%8F%91%EF%BC%8C%E7%A1%AE%E4%BF%9D%E6%B5%8B%E8%AF%95%E7%8E%AF%E5%A2%83%E7%9A%84%E4%B8%80%E8%87%B4%E6%80%A7%E5%92%8C%E7%A8%B3%E5%AE%9A%E6%80%A7%E3%80%82

核心功能与特性

• 基于OpenMRS SDK构建：通过OpenMRS SDK（版本3.7.0及以上）生成，确保应用打包的标准化和可靠性。
• 多标签支持：提供多种标签满足不同需求，包括：
  • nightly：每次构建成功后更新，包含最新开发版本
  • latest：最新稳定发布版本
  • 版本号标签（如2.5、2.6等）：特定发布版本
  • 测试服务器版本：详情可参考OpenMRS环境文档
• 环境变量配置：支持通过环境变量灵活配置数据库连接及应用行为。

使用场景

• OpenMRS测试环境搭建
• 参考应用功能演示与验证
• 开发环境中快速部署OpenMRS应用实例

使用方法与配置说明

镜像拉取

从Docker Hub拉取指定标签的镜像：

bash
docker pull docker.xuanyuan.run/openmrs/openmrs-reference-application:<tag>

其中<tag>可替换为nightly、latest或具体版本号（如2.6）。

运行容器

基本运行命令示例（需提前配置数据库）：

bash
docker run -d \
  -e DB_HOST=db-host \
  -e DB_DATABASE=openmrs \
  -e DB_USERNAME=db-user \
  -e DB_PASSWORD=db-pass \
  -p 8080:8080 \
  docker.xuanyuan.run/openmrs/openmrs-reference-application:latest

环境变量配置

镜像支持以下环境变量，用于配置应用行为：

镜像生成流程（参考）

该镜像通过OpenMRS SDK生成，具体流程如下（供参考）：

bash
# 使用OpenMRS SDK构建分发版
mvn org.openmrs.maven.plugins:openmrs-sdk-maven-plugin:3.7.0:build-distro -B -Ddir=demo-server -Ddistro=referenceapplication:<version> -Dbundled=true

# 进入生成的Web目录构建Docker镜像
cd demo-server/web/
docker build -t openmrs/openmrs-reference-application-distro:<version> .

# 推送镜像至Docker Hub
docker push openmrs/openmrs-reference-application-distro:<version>

注：-Dbundled=true选项从版本2.6开始支持。