openmrs/openmrs-core

OpenMRS Core Docker镜像文档

1. 镜像概述和主要用途

OpenMRS Core Docker镜像是为OpenMRS（开源***记录系统）核心组件提供的容器化解决方案，设计为OpenMRS开发环境和生产环境的基础镜像。该镜像目前处于开发完善阶段，旨在简化OpenMRS Core的部署流程，提供一致的运行环境。

注意：镜像仍在持续优化中，欢迎通过https://github.com/openmrs/openmrs-core#docker-build%E6%8F%90%E4%BE%9B%E5%8F%8D%E9%A6%88%E5%92%8C%E6%94%B9%E8%BF%9B%E5%BB%BA%E8%AE%AE%E3%80%82

2. 核心功能和特性

• 基础运行环境：内置OpenMRS Core运行所需的依赖组件，无需手动配置底层环境。
• 多环境支持：支持开发（Development）和生产（Production）两种模式，可通过配置切换。
• 可定制化：允许通过环境变量、配置文件挂载等方式自定义OpenMRS Core实例参数。
• 轻量化设计：基于官方基础镜像构建，优化镜像体积，提升部署效率。

3. 使用场景和适用范围

3.1 开发环境

• OpenMRS Core功能开发与调试
• 插件（Module）开发测试
• 本地快速搭建OpenMRS原型环境

3.2 生产环境

• 中小型***机构OpenMRS系统部署
• 基于OpenMRS Core的***记录系统生产实例运行
• 容器化平台（如Kubernetes、Docker Swarm）中的OpenMRS服务编排

3.3 其他场景

• OpenMRS Core版本升级测试
• 多版本OpenMRS实例并行运行（如测试环境与生产环境隔离）

4. 使用方法和配置说明

4.1 获取镜像

目前镜像需通过源码构建（官方镜像仓库暂未发布），构建方法参考https://github.com/openmrs/openmrs-core#docker-build%E3%80%82

4.2 快速启动（docker run示例）

bash
docker run -d \
  --name openmrs-core \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=dev \
  -e DB_HOST=mysql-host \
  -e DB_PORT=3306 \
  -e DB_NAME=openmrs \
  -e DB_USER=openmrs_user \
  -e DB_PASSWORD=openmrs_pass \
  openmrs/core:latest

参数说明：

• -p 8080:8080：映射容器内8080端口到宿主机8080端口（OpenMRS默认Web端口）。
• SPRING_PROFILES_ACTIVE=dev：指定运行环境为开发模式（生产环境可改为prod）。
• 数据库相关变量（DB_HOST、DB_PORT等）：配置OpenMRS连接的外部数据库信息。

4.3 docker-compose部署示例

创建docker-compose.yml文件，配置OpenMRS Core与MySQL数据库的联动部署：

yaml
version: '3.8'

services:
  openmrs-core:
    image: openmrs/core:latest
    container_name: openmrs-core
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_NAME=openmrs
      - DB_USER=root
      - DB_PASSWORD=rootpassword
      - SERVER_PORT=8080
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: mysql:8.0
    container_name: openmrs-mysql
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - MYSQL_DATABASE=openmrs
    volumes:
      - mysql-data:/var/lib/mysql
    restart: unless-stopped

volumes:
  mysql-data:

启动命令：

bash
docker-compose up -d

5. 配置参数说明

5.1 核心环境变量

5.2 数据持久化

为避免容器重启导致数据丢失，建议通过-v参数挂载以下目录：

• OpenMRS配置文件目录：/openmrs/configuration
• 模块存储目录：/openmrs/modules
• 日志目录：/openmrs/logs

示例（docker run挂载）：

bash
docker run -d \
  -v /host/path/to/config:/openmrs/configuration \
  -v /host/path/to/modules:/openmrs/modules \
  -v /host/path/to/logs:/openmrs/logs \
  openmrs/core:latest

6. 注意事项

1. 镜像状态：当前镜像处于开发阶段，功能和配置可能随版本更新发生变化，建议定期查看https://github.com/openmrs/openmrs-core#docker-build%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E4%BF%A1%E6%81%AF%E3%80%82
2. 数据库依赖：镜像本身不包含数据库，需通过环境变量配置外部数据库（如MySQL、PostgreSQL），生产环境建议使用独立部署的数据库服务并开启持久化。
3. 性能调优：生产环境中需根据实际负载调整JVM参数（如内存分配），可通过JAVA_OPTS环境变量自定义（例如JAVA_OPTS="-Xms512m -Xmx1g"）。
4. 安全配置：生产环境中需修改默认数据库密码、限制容器网络访问权限，并避免挂载敏感目录到公网可访问路径。