Qvera Interface Engine (QIE) Docker镜像文档

快速参考

• 获取帮助： Qvera支持请求、Qvera知识库 或 Qvera官网

什么是Qvera Interface Engine (QIE)？

Qvera Interface Engine (QIE) 用于促进不同信息系统（HIT）间的数据传输和健康信息交换，支持多种标准消息格式（如HL7、XML（CCDA、SOAP等）、JSON（HL7 FHIR）、EDIFACT、CSV、X12、ASTM、DICOM等），并利用标准通信协议（如MLLP Socket、HTTP(s)接收器、Web服务（REST、SOAP等）、FTP、SFTP、文件/文件夹监控和DICOM Socket）。

!Qvera主标志

如何使用此镜像

启动QIE节点实例

要使用默认配置运行QIE，使用以下命令：

bash
$ docker run -p 80:80 qvera/qie:tag

其中 <code>tag</code> 是指定所需QIE版本的标签。之后可通过浏览器访问 http://localhost 或 [***] 来使用QIE。

可通过 JETTY_PORT 环境变量定义替代监听端口：

bash
$ docker run -p 80:80 -e JETTY_PORT=80 qvera/qie:tag

要停止QIE，使用以下命令：

bash
$ docker stop -t 300 [容器ID...]

QIE需要最多五分钟时间正常关闭。

通过docker stack部署或docker-compose

使用MariaDB数据库运行QIE的示例stack.yml：

yaml
version: "3.7"

services:
  qie:
    image: qvera/qie:latest
    restart: always
    ports:
      - "80:80"
    environment:
      JAVA_OPTIONS: -Xmx2048m
      connection_driver: org.mariadb.jdbc.Driver
      connection_url: jdbc:mariadb://db:3306/qie
      connection_username: root
      connection_password: root
      hibernate_dialect: com.qvera.qie.persistence.MariaDB103UnicodeDialect
      qie_haEngine: EnterpriseHAServiceImpl
    stop_grace_period: 5m
    healthcheck:
      test: curl --fail -s http://localhost/qieStatus || exit 1
      interval: 10s
      timeout: 10s
      retries: 3
      start_period: "6h"
    depends_on:
      - db

  db:
    image: mariadb:10.5.17
    environment:
      MYSQL_ROOT_PASSWORD: root
    restart: always
    volumes:
      - init_data:/docker-entrypoint-initdb.d/
      - db_data:/var/lib/mysql:rw
    depends_on:
      - dbSetup

  dbSetup:
    image: alpine:latest
    command:
      - "/bin/sh"
      - "-c"
      - "echo \"create schema if not exists qie;\" > /init_script/schema.sql"
    volumes:
      - init_data:/init_script

volumes:
  init_data:
  db_data:

运行 docker stack deploy -c stack.yml qie（或 docker-compose -f stack.yml up），等待完全初始化后，通过 [***]、http://localhost:80 或 [***]（根据实际情况）访问QIE。

注意：健康检查设置了6小时延迟，以便在升级时给镜像足够时间更新大型数据库的模式。

注意2：dbSetup镜像用于创建schema.sql脚本，在新MariaDB数据库中创建QIE数据库模式。

向QIE传递Java选项

可通过 JAVA_OPTIONS 环境变量向QIE传递Java VM选项：

bash
$ docker run -p 80:80 \
   -e "JAVA_OPTIONS=-Xmx2048m -XX:+HeapDumpOnOutOfMemoryError" \
   -e connection_driver=org.mariadb.jdbc.Driver \
   -e connection_url=jdbc:mariadb://127.0.0.1:3306/qie \
   -e connection_username=root \
   -e connection_password=root \
   -e hibernate_dialect=com.qvera.qie.persistence.MariaDB103UnicodeDialect \
    qvera/qie:tag

JVM特定选项可通过 JAVA_OPTIONS 环境变量传递，多个选项用空格分隔。此外，QIE特定选项也可在此添加，但通过环境变量提供更清晰。包含空格的值需用双引号括起。

数据存储位置

QIE可配置使用MariaDB、MySQL或Microsoft SQL Server，通过指定数据库连接参数连接目标数据库：

bash
$ docker run -p 80:80 \
   -e connection_driver=myConnectionDriver \
   -e connection_url=myConnectionUrl \
   -e connection_username=myConnectionUsername \
   -e connection_password=myConnectionPassword \
   -e hibernate_dialect=myHibernateDialect \
   -v /java/qie/jdbcDriver:/java/qie/jdbcDriver:rw \
   qvera/qie:tag

运行MySQL时，需将JDBC驱动作为卷挂载（运行MariaDB或Microsoft SQL Server时，镜像已包含JDBC驱动）。有关设置这些数据库供QIE使用的信息，可参考以下链接：

• MariaDB：[***]
• MySQL：[***]
• Microsoft SQL Server：[***]

QIE备份存储位置

QIE执行系统配置的夜间备份。要在容器停止时保留备份，添加以下卷：

bash
$ docker run -p 80:80 \
    -v /java/qie/backup:/java/qie/backup:rw \
    qvera/qie:tag

此外，QIE支持备份到替代位置，在“系统配置 -> 系统配置夜间备份 -> 替代路径”下定义。使用此功能时，需为此位置添加卷。

QIE日志存储位置

QIE同时记录日志到STDOUT和文件。要在容器停止时保留日志，需添加以下卷：

bash
$ docker run -p 80:80 \
    -v /java/qie/logs:/java/qie/logs:rw \
    qvera/qie:tag

外部库

JAR文件可添加到QIE并使用，所有外部JAR文件必须存储在 /java/qie/lib 文件夹中。

单个JAR文件可作为卷添加，例如添加VTD库：

bash
$ docker run -p 80:80 \
    -v ./vtd-xml-qvera-2.11.3.jar:/java/qie/lib/vtd-xml-qvera-2.11.3.jar:ro \
    qvera/qie:tag

对于多个库，可使用包含所有外部JAR文件的lib目录，而非单独指定每个JAR。此文件夹可包含单个JAR文件或包含JAR文件的子文件夹：

bash
$ docker run -p 80:80 \
    -v /java/qie/lib:/java/qie/lib:ro \
    qvera/qie:tag

高可用性

要允许QIE在集群环境中运行，所用数据库必须设置内存表。使用MySQL或MariaDB时，这些表会自动设置；使用Microsoft SQL Server时，需按照此处说明手动设置内存表。设置完成后，需向QIE容器提供以下环境变量：

bash
$ docker run -p 80:80 \
    -e qie_haEngine=EnterpriseHAServiceImpl \
    qvera/qie:tag

使用新版本QIE升级集群时，所有容器需同时更新。