openneuro/datalad-service

OpenNeuro后端DataLad容器

镜像概述

本镜像为OpenNeuro平台的后端服务容器，提供HTTP接口用于创建、更新和导出DataLad数据集。由于底层Git/DataLad API在多数情况下不支持并发操作，镜像通过为每个仓库分配专属读队列解决此问题，支持多客户端通过OpenNeuro实现的高层API访问同一仓库。

核心功能与特性

• HTTP接口支持：提供数据集创建、更新及导出的HTTP接口
• 并发控制机制：通过专属读队列管理仓库访问，解决Git/DataLad API的并发限制
• 数据验证集成：需配合bids-validator进行数据格式验证

使用场景与适用范围

适用于OpenNeuro平台后端，支持神经科学研究数据（如BIDS格式）的管理与访问，满足多客户端对DataLad数据集的并发操作需求。

使用方法与配置说明

环境准备

安装Python依赖

bash
# 创建并激活Python虚拟环境
virtualenv --python python3 .venv
source .venv/bin/activate

# 安装Python依赖包
pip install -r requirements.txt

安装bids-validator

需通过npm或Yarn安装bids-validator：

bash
# 使用Yarn安装
yarn

或

bash
# 使用npm安装
npm install

运行服务

通过gunicorn启动应用，指定仓库路径：

bash
gunicorn --reload "datalad_service.app:create_app('/path-to-repos')"

注：/path-to-repos需替换为实际仓库存储路径

测试

使用pytest执行测试：

bash
pytest