markw/yarrrml-parser-ejp

yarrrml-parser-ejp Docker镜像文档

镜像概述和主要用途

本镜像基于rml.io的yarrrml-parser构建，将YARRRML到RML的转换功能封装为Web服务，可通过HTTP请求触发转换。主要用于在Docker Compose环境中作为独立服务运行，方便集成到更大的数据处理管道或多组件交互网络中，实现YARRRML配置文件到RML映射语言的自动化转换。

核心功能和特性

• Web服务接口：通过HTTP接口提供YARRRML到RML的转换功能
• 文件路径指定：支持通过URL参数指定输入YARRRML文件和输出RML文件路径
• 数据卷挂载：通过Docker卷挂载本地目录，实现容器与宿主机的数据共享
• 多容器协作：可作为Docker Compose中的服务组件，与其他容器服务直接通信

使用场景和适用范围

• 数据转换管道中需要集成YARRRML到RML转换步骤的场景
• Docker Compose环境下的多服务协同数据处理流程
• 需要通过Web接口触发配置文件转换的自动化任务
• 本地开发环境中快速进行YARRRML到RML的转换测试

详细使用方法和配置说明

Docker Compose配置

创建docker-compose.yml文件，配置如下：

yaml
version: "2.0"
services:
  yarrrml_transform: 
    image: markw/yarrrml-parser-ejp:latest
    container_name: yarrrml_transform
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data

数据目录准备

在与docker-compose.yml同级目录下创建data文件夹（./data），并将待转换的YARRRML文件放入该目录。

启动服务

执行以下命令启动服务：

bash
docker-compose up -d

调用转换功能

本地调用

通过本地浏览器或HTTP客户端访问以下URL触发转换：

http://localhost:3000/?parserin=/data/[输入文件名].yarml&parserout=/data/[输出文件名].rml

示例（假设data目录下有myfile.yarml）：

http://localhost:3000/?parserin=/data/myfile.yarml&parserout=/data/myfile.rml

Docker Compose网络中其他服务调用

当在同一Docker Compose网络中的其他服务需要调用时，使用服务名代替localhost：

http://yarrrml_transform:3000/?parserin=/data/[输入文件名].yarml&parserout=/data/[输出文件名].rml

参数说明

• parserin：必选参数，指定容器内YARRRML输入文件路径（需位于/data目录下）
• parserout：必选参数，指定容器内RML输出文件路径（将保存到/data目录下）

输出结果

转换成功后，RML文件将保存到./data目录（宿主机）下，与parserout参数指定的文件名一致。