OpenMRS 3.0 Reference Application Backend Docker镜像文档

1. 镜像概述和主要用途

1.1 概述

本镜像包含OpenMRS 3.0 Reference Application的后端服务，基于Tomcat容器构建并提供服务。该镜像仅提供OpenMRS后端功能，必须由用户自行提供数据库服务以确保完整运行。

2. 核心功能和特性

• 后端服务支持：作为OpenMRS 3.0参考应用的核心后端，处理业务逻辑和数据交互
• 容器化部署：基于Tomcat容器运行，简化部署流程并确保环境一致性
• 多数据库兼容：支持MySQL/MariaDB和PostgreSQL数据库，通过环境变量配置切换
• 灵活配置：通过环境变量自定义数据库连接参数、认证信息等关键配置

3. 使用场景和适用范围

3.1 适用场景

• ***机构信息系统中部署OpenMRS 3.0参考应用的后端服务
• OpenMRS 3.0应用的开发、测试环境搭建
• ***健康数据管理系统的后端服务基础设施构建

3.2 适用范围

• 需要独立部署OpenMRS 3.0后端服务的场景
• 已具备独立数据库服务（MySQL/MariaDB或PostgreSQL）的环境
• 支持Docker容器化部署的服务器或开发环境

4. 使用方法和配置说明

4.1 环境变量配置

4.1.1 核心环境变量（必填项）

4.1.2 核心环境变量（可选项）

注：更多环境变量详见Dockerfile

4.2 部署示例

4.2.1 使用docker run部署

需提前确保数据库服务已运行（以下示例以MySQL为例）：

bash
docker run -d \
  --name openmrs-backend \
  -p 8080:8080 \
  -e OMRS_CONFIG_CONNECTION_USERNAME=dbuser \
  -e OMRS_CONFIG_CONNECTION_PASSWORD=dbpass \
  -e OMRS_CONFIG_DATABASE=mysql \
  -e OMRS_CONFIG_CONNECTION_SERVER=mysql-host \
  -e OMRS_CONFIG_CONNECTION_DATABASE=openmrs_db \
  -e OMRS_CONFIG_CONNECTION_EXTRA_ARGS="&useSSL=false&serverTimezone=UTC" \
  openmrs/openmrs-distro-referenceapplication:latest

4.2.2 使用docker-compose部署（含MySQL数据库）

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  openmrs-backend:
    image: openmrs/openmrs-distro-referenceapplication:latest
    ports:
      - "8080:8080"
    environment:
      - OMRS_CONFIG_CONNECTION_USERNAME=root
      - OMRS_CONFIG_CONNECTION_PASSWORD=mysqlrootpass
      - OMRS_CONFIG_DATABASE=mysql
      - OMRS_CONFIG_CONNECTION_SERVER=mysql-db
      - OMRS_CONFIG_CONNECTION_DATABASE=openmrs
      - OMRS_CONFIG_CONNECTION_EXTRA_ARGS="&useSSL=false&serverTimezone=UTC"
    depends_on:
      - mysql-db

  mysql-db:
    image: mysql:8.0
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=mysqlrootpass
      - MYSQL_DATABASE=openmrs
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

5. 镜像标签说明

注：更多镜像信息可访问***仓库获取。