cdiscdocker/cdisc-rules-engine

CDISC规则引擎Docker镜像

本Docker镜像包含CDISC规则引擎，这是一款用于验证临床试验数据是否符合CDISC标准的工具。容器使用CDISC Core Engine仓库的最新版本。更多信息请访问：
https://github.com/cdisc-org/cdisc-rules-engine
CDISC官方网站

快速开始

拉取镜像

从Docker Hub拉取镜像：

docker pull docker.xuanyuan.run/cdiscdocker/cdisc-rules-engine:latest

基本使用

验证数据的通用命令格式：

docker run --rm -it \
  -v /本地输出路径:/data/output \
  -v /本地数据集路径:/data/input \
  docker.xuanyuan.run/cdiscdocker/cdisc-rules-engine /app/core validate -s <标准> -v <版本> -d /data/input -o /data/output/报告名称

此命令将本地的数据集目录和输出目录挂载到容器，使容器可访问数据集并将报告输出到本地。请替换/本地输出路径、/本地数据集路径和报告名称为实际值。

Windows（PowerShell）示例：

docker run --rm -it `
  -v "C:\输出路径:/data/output" `
  -v "C:\数据集路径:/data/input" `
  cdiscdocker/cdisc-rules-engine /app/core validate -s sdtmig -v 3-4 -d /data/input -o /data/output/report

Linux/Mac示例：

docker run --rm -it \
  -v "$(pwd):/data/output" \
  -v "/数据集绝对路径:/data/input" \
  docker.xuanyuan.run/cdiscdocker/cdisc-rules-engine /app/core validate -s sdtmig -v 3-4 -d /data/input -o /data/output/report

注：$(pwd)可用于Windows、Linux或Mac，指代当前工作目录作为输出目录。

参数说明

• -s <标准>：指定CDISC标准（如sdtmig、adamig）
• -v <版本>：标准版本（如3-4）
• -d /data/input：输入数据集目录（从本地挂载）
• -o /data/output/report：验证报告输出文件

额外命令

查看所有可用命令：

docker run --rm docker.xuanyuan.run/cdiscdocker/cdisc-rules-engine /app/core --help

查看命令选项：

docker run --rm docker.xuanyuan.run/cdiscdocker/cdisc-rules-engine /app/core 命令 --help

注意事项

• 容器默认以root用户运行，若遇权限问题需调整输出目录所有权。
• 运行update-cache命令需提供CDISC Library API密钥，可通过以下两种方式：

1. 设置环境变量传递密钥： UNIX：

export CDISC_API_KEY="你的API密钥"
docker run --rm -e CDISC_LIBRARY_API_KEY=$CDISC_API_KEY docker.xuanyuan.run/cdiscdocker/cdisc-rules-engine /app/core 命令 --help

Windows PowerShell：

$env:CDISC_LIBRARY_API_KEY="你的API密钥"
docker run --rm -e CDISC_LIBRARY_API_KEY=$env:CDISC_LIBRARY_API_KEY docker.xuanyuan.run/cdiscdocker/cdisc-rules-engine /app/core 命令 --help

也可直接使用环境变量：

docker run docker.xuanyuan.run/cdiscdocker/cdisc-rules-engine /app/core update-cache --apikey $env:CDISC_LIBRARY_API_KEY

2. 使用Docker Secret（需Swarm模式）：

docker swarm init

UNIX：

export CDISC_LIBRARY_API_KEY="你的API密钥" 
echo $CDISC_LIBRARY_API_KEY | docker secret create cdisc_api_key - 
docker service create \
    --name cdisc-rules-engine \
    --secret cdisc_api_key \
    --mount type=bind,source=输出目录路径,target=/data/output \
    --mount type=bind,source=数据集路径,target=/data/input \
    --replicas 1 \
    --restart-condition none \
    cdiscdocker/cdisc-rules-engine
docker service logs -f cdisc-rules-engine

Windows PowerShell：

$env:CDISC_LIBRARY_API_KEY = "你的API密钥"
echo $env:CDISC_LIBRARY_API_KEY | docker secret create cdisc_api_key -
docker service create `
    --name cdisc-rules-engine `
    --secret cdisc_api_key `
    --mount type=bind,source=数据集路径,target=/data/input `
    --mount type=bind,source=输出目录路径,target=/data/output `
    --replicas 1 `
    --restart-condition none `
    cdiscdocker/cdisc-rules-engine

故障排除

部分macOS用户（尤其是M1 Mac）使用相对路径挂载数据时可能遇到以下错误：

docker
The path /path/to/data is not shared from the host and is not known to Docker.
You can configure shared paths from Docker -> Preferences... -> Resources -> File Sharing.
See https://docs.docker.com/desktop/settings/mac/#file-sharing for more info

解决方法：使用数据集的绝对路径代替相对路径：

docker run --rm -it \
  -v "$(pwd):/data/output" \
  -v "/数据集绝对路径:/data/input" \
  docker.xuanyuan.run/cdiscdocker/cdisc-rules-engine /app/core validate -s sdtmig -v 3-4 -d /data/input -o /data/output/report

问题反馈

若遇到Docker实现相关问题，请访问GitHub创建标题包含[Docker]的工单，我们将尽快处理。

注意

本文档中的示例命令仅用于CLI环境的测试和演示，不适合生产环境。用户需自行负责生产环境的实现，命令和配置可能需根据基础设施、安全或合规要求调整。部署前请在非生产环境测试，并咨询IT/DevOps团队。