fnndsc/pl-simpledsapp Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

pl-simpledsapp

镜像概述和主要用途

pl-simpledsapp是一个简单的ChRIS ds应用演示镜像。其核心功能是将输入目录中的每个文件显式复制到输出目录，并支持为输出文件名添加可选前缀，主要用于展示ChRIS生态系统中数据处理应用的基本结构和功能。

核心功能和特性

• 文件复制：将输入目录中的文件完整复制到输出目录
• 文件名前缀：支持为输出文件名添加自定义前缀
• 灵活配置：提供多种可选参数，如忽略输入目录、操作前睡眠时长等
• 元数据支持：可输出应用元数据及JSON格式描述

使用场景和适用范围

• ChRIS应用开发入门演示
• 简单文件批量复制与重命名需求
• 教学环境中展示容器化数据处理流程
• 作为基础模板构建更复杂的ChRIS应用

使用方法和配置说明

命令格式

python simpledsapp.py
    [-h] [--help]
    [--json]
    [--man]
    [--meta]
    [--savejson <DIR>]
    [-v <level>] [--verbosity <level>]
    [--version]
    <inputDir>
    <outputDir>
    [--prefix <PREFIX>]
    [--ignoreInputDir]
    [--sleepLength <SECONDS>]
    [--dummyInt <INT>]
    [--dummyFloat <FLOAT>]

参数说明

• 基本帮助参数

  • -h, --help: 显示帮助信息并退出
  • --json: 显示应用的JSON表示并退出
  • --man: 显示完整帮助文档并退出
  • --meta: 显示插件元数据并退出
  • --savejson <DIR>: 将JSON表示保存到指定目录并退出
  • -v <level>, --verbosity <level>: 日志详细级别（当前未使用）
  • --version: 显示版本号并退出

• 必选参数

  • <inputDir>: 输入目录路径
  • <outputDir>: 输出目录路径

• 可选参数

  • --prefix <PREFIX>: 为输出文件名添加前缀
  • --ignoreInputDir: 完全忽略输入目录（不执行复制操作）
  • --sleepLength <SECONDS>: 执行操作前的睡眠时长（秒）
  • --dummyInt <INT>: 示例整数参数（未实际使用）
  • --dummyFloat <FLOAT>: 示例浮点数参数（未实际使用）

Docker部署示例

获取帮助信息

bash
docker run --rm fnndsc/pl-simpledsapp simpledsapp --man

基本运行命令

bash
docker run --rm -u $(id -u) \
    -v $(pwd)/in:/incoming -v $(pwd)/out:/outgoing \
    fnndsc/pl-simpledsapp simpledsapp \
    /incoming /outgoing

添加文件名前缀示例

bash
docker run --rm -u $(id -u) \
    -v $(pwd)/in:/incoming -v $(pwd)/out:/outgoing \
    fnndsc/pl-simpledsapp simpledsapp \
    /incoming /outgoing --prefix lolo

开发指南

构建本地镜像

bash
docker build -t local/pl-simpledsapp .

运行单元测试

bash
docker run --rm local/pl-simpledsapp nosetests

相关链接

• ChRIS Store