docker_fhir_validator

镜像概述和主要用途

docker_fhir_validator是FHIR Core Validator的Docker镜像来源，兼容6.2.10及以上版本的FHIR Core Validator。该镜像提供基于OpenJDK 11和OpenJDK 17的两个版本，分别托管于Docker Hub，可快速部署用于FHIR资源验证。

核心功能和特性

• 多JDK版本支持：提供OpenJDK 11和OpenJDK 17两种环境，满足不同项目的Java版本需求
• 版本灵活性：支持拉取最新版FHIR Core Validator，也可指定特定版本（如6.3.13）
• 便捷部署：镜像托管于Docker Hub，通过简单命令即可拉取和验证
• 离线验证支持：可加载本地包缓存（Package Cache）实现FHIR资源的离线验证

使用场景和适用范围

• FHIR资源验证：适用于开发、测试环境中对FHIR资源（如Patient、Observation等）的结构和合规性验证
• 多环境适配：满足需基于OpenJDK 11或17运行FHIR验证工具的场景
• 离线工作流：支持无网络环境下通过本地包缓存进行FHIR资源验证

使用方法和配置说明

前提条件

• 已安装Docker且docker命令可正常执行

拉取镜像

根据所需的OpenJDK版本和FHIR Core Validator版本，选择以下命令拉取镜像：

拉取最新版本

• OpenJDK 11版本（包含OpenJDK 11和最新FHIR Core Validator）：

  sh
  docker pull peter279k/docker_fhir_validator_11:latest
  

• OpenJDK 17版本（包含OpenJDK 17和最新FHIR Core Validator）：

  sh
  docker pull peter279k/docker_fhir_validator_17:latest
  

拉取特定版本

如需指定FHIR Core Validator版本（如6.3.13），可通过标签拉取：

• OpenJDK 11 + FHIR Core Validator 6.3.13：

  sh
  docker pull peter279k/docker_fhir_validator_11:6.3.13
  

验证镜像

拉取成功后，可通过以下命令验证镜像是否正常工作（以OpenJDK 11为例）：

sh
docker run peter279k/docker_fhir_validator_11:latest java -jar validate_cli.jar -help

执行后将显示FHIR Core Validator的帮助信息，确认工具可正常运行。

离线验证配置

如需通过本地包缓存进行离线验证，按以下步骤操作：

1. 准备包缓存和示例文件

sh
# 下载IG包缓存压缩包
wget -O package.tgz [***]

# 创建IG目录
mkdir tw.gov.mohw.twcore

# 解压包缓存到指定目录
tar -xvzf package.tgz -C tw.gov.mohw.twcore

# 下载并解压示例JSON文件
wget -O examples.json.zip [***]
rm -rf examples.json && mkdir examples.json && unzip examples.json.zip -d examples.json

2. 运行离线验证

通过挂载本地目录到容器，执行验证命令（以OpenJDK 11为例）：

sh
docker run \
    -v $PWD/tw.gov.mohw.twcore:/root/.fhir/packages/tw.gov.mohw.twcore \  # 挂载包缓存目录
    -v $PWD/examples.json:/root/examples.json \  # 挂载示例文件目录
    peter279k/docker_fhir_validator_11:latest -c "cd /root/ && java -Dfile.encoding=UTF-8 -jar validator_cli.jar ./examples.json/Patient-pat-example.json -version 4.0 -ig tw.gov.mohw.twcore"

该命令将使用本地包缓存验证示例Patient资源（FHIR 4.0版本）。