openmrs/openmrs-distro-platform

OpenMRS Platform Docker镜像文档

1. 镜像概述

OpenMRS Platform Docker镜像是由OpenMRS官方基于OpenMRS SDK（版本3.7.0+）构建的标准化镜像，用于快速部署OpenMRS Platform环境。该镜像通过CI流程（[] Hub，主要应用于测试环境（参考：[]

2. 核心功能与特性

• 数据库配置灵活性：支持自定义数据库地址、用户名、密码及数据库名，适配各类数据库环境。
• 自动化表结构管理：可配置是否自动创建数据库表（DB_CREATE_TABLES）及自动更新表结构（DB_AUTO_UPDATE），简化初始化流程。
• 模块管理功能：默认启用模块Web管理（MODULE_WEB_ADMIN），支持通过Web界面管理OpenMRS模块。
• 调试支持：提供DEBUG模式，便于开发和测试阶段的问题排查。
• 标准化部署：基于OpenMRS SDK构建，确保环境一致性和部署可靠性。

3. 使用场景与适用范围

• 测试环境：用于OpenMRS Platform功能测试、模块兼容性测试、版本升级验证等。
• 开发环境：简化开发流程，快速搭建本地开发实例，减少环境配置复杂度。
• 演示环境：快速部署OpenMRS Platform演示实例，展示核心功能。

4. 使用方法与部署示例

4.1 Docker run命令部署

通过以下命令快速启动容器，需根据实际环境替换数据库参数：

bash
docker run -d \
  --name openmrs-platform \
  -p 8080:8080 \
  -e DB_HOST=mysql-host \
  -e DB_USERNAME=openmrs \
  -e DB_PASSWORD=openmrs-password \
  -e DB_DATABASE=openmrs \
  -e DB_CREATE_TABLES=true \
  -e DB_AUTO_UPDATE=true \
  openmrs/openmrs-distro-platform:<version>

说明：

• <version>需替换为具体镜像版本号（如2.5.0）；
• mysql-host为数据库主机地址（本地数据库可通过--link或自定义网络连接）；
• 首次启动建议设置DB_CREATE_TABLES=true以初始化表结构。

4.2 docker-compose配置示例

以下配置集成OpenMRS Platform与MySQL，实现一站式部署：

yaml
version: '3'
services:
  mysql:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: root-password
      MYSQL_DATABASE: openmrs
      MYSQL_USER: openmrs
      MYSQL_PASSWORD: openmrs-password
    volumes:
      - mysql-data:/var/lib/mysql
    restart: always

  openmrs-platform:
    image: openmrs/openmrs-distro-platform:<version>
    depends_on:
      - mysql
    ports:
      - "8080:8080"
    environment:
      DB_HOST: mysql
      DB_USERNAME: openmrs
      DB_PASSWORD: openmrs-password
      DB_DATABASE: openmrs
      DB_CREATE_TABLES: "true"  # 首次启动创建表结构
      DB_AUTO_UPDATE: "true"    # 自动更新表结构
      MODULE_WEB_ADMIN: "true"  # 启用模块Web管理
      DEBUG: "false"            # 禁用调试模式
    restart: always

volumes:
  mysql-data:

说明：首次启动后，建议将DB_CREATE_TABLES改为false，避免重复创建表导致冲突。

5. 环境变量配置参数

注意：DB_CREATE_TABLES仅建议首次部署时设为true；DEBUG模式会降低性能，生产环境禁用。