hmsdbmitc/hapi-fhir

DBMI HAPI-FHIR容器

镜像概述

该容器在Tomcat上运行HAPI-FHIR（***健康信息交换标准）服务，并通过nginx代理，适用于AWS ECS容器部署环境。它可从PS获取运行配置，通过Auth0 JWT实现认证与授权管理，专为内部部署场景设计。

核心功能

• 在Tomcat上运行HAPI-FHIR服务，支持FHIR标准的***数据资源管理
• 通过nginx代理HAPI-FHIR服务
• 适配AWS ECS容器部署模式
• 基于Auth0 JWT实现认证（AuthN）与授权（AuthZ）
• 支持MySQL数据持久化
• 可通过环境变量配置JWT开关及相关参数

使用场景

适用于内部健康系统中，基于FHIR标准的数据资源存储、交换与管理场景，支持与其他***系统的集成。

构建说明

使用以下命令构建容器。HAPI_FHIR_VERSION构建参数指定pom.xml中依赖的HAPI-FHIR版本，HAPI_FHIR_SOURCE参数指定需复制到镜像中用于构建的Maven项目目录（因HAPI-FHIR 2.x与3.x.x包差异，需分开项目源）。此外包含用于测试和通过Web UI查看FHIR资源的HAPI-FHIR overlay项目。

bash
docker build . -t dbmi/hapi-fhir:2.5-overlay --build-arg HAPI_FHIR_VERSION=2.5 --build-arg HAPI_FHIR_SOURCE=hapi-fhir-2.x-overlay

运行说明

该项目需将数据持久化到MySQL实例，并通过JWT进行认证授权。可通过环境变量配置相关参数，包括禁用JWT认证授权的选项。还需配置nginx监听端口、服务器名称及FHIR绝对服务URL，以确保代理后资源URL正确返回。

bash
docker run -d -e APP_PORT=8080 \
    -e FHIR_MYSQL_URL=<数据库URL> \
    -e FHIR_MYSQL_USERNAME=<数据库用户名> \
    -e FHIR_MYSQL_PASSWORD=<数据库密码> \
    -e JWT_ISSUER=https://<客户端>.auth0.com/ \
    -e JWT_AUDIENCE=<Auth0客户端ID> \
    -e JWT_HEADER_PREFIX="JWT " \
    -e JWT_COOKIE_NAME="DBMI_JWT" \
    -e JWT_AUTHZ_CLAIM=[***] \
    -e JWT_ADMIN_GROUP=fhir-admin \
    --name hapi-fhir dbmi/hapi-fhir:2.5-overlay