Rucio - 科学数据管理（守护进程容器）

1. 镜像概述和主要用途

Rucio 是一个科学数据管理框架，提供组织、管理和访问大量科学数据的功能，支持自定义策略。数据可分布在全球不同位置和异构数据中心，将不同的存储和网络技术整合为单一联邦实体。本镜像提供 Rucio 守护进程，每个守护进程需在独立容器中运行，支持 MySQL、PostgreSQL、Oracle 和 SQLite 作为数据库后端。

2. 核心功能和特性

分布式数据管理：支持全球分布式存储环境，整合异构数据中心资源
高级数据功能：提供分布式数据恢复、自适应复制等高级特性
高可扩展性：模块化架构设计，支持大规模科学数据场景
多数据库支持：兼容 MySQL、PostgreSQL、Oracle 和 SQLite 数据库后端
灵活配置：通过环境变量或配置文件（rucio.cfg）进行全面配置
守护进程隔离：每个守护进程独立容器运行，提高稳定性和可维护性

3. 使用场景和适用范围

本镜像适用于需要运行 Rucio 守护进程的场景，主要面向：

高能物理实验（如 ATLAS）数据管理
LHC 实验及其他科学社区的分布式数据处理
需要管理大规模、跨地域科学数据的研究机构
需部署 Rucio 框架中各类守护进程（如 judge-cleaner、hermes、kronos 等）的环境

4. 使用方法和配置说明

4.1 前提条件

已初始化的 Rucio 数据库（需提前部署并配置）
Docker 环境（支持 Docker Engine 或 Docker Compose）

4.2 基本使用示例

通过环境变量配置数据库连接并启动守护进程：

bash
docker run \
  --name=rucio-judge-cleaner \
  -e RUCIO_CFG_DATABASE_DEFAULT="mysql://rucio:***/rucio" \  # 数据库连接串
  -e RUCIO_DAEMON=judge-cleaner \  # 指定守护进程名称
  rucio/rucio-daemons

参数说明：

RUCIO_CFG_DATABASE_DEFAULT：数据库连接地址，格式为<数据库类型>://<用户名>:<密码>@<主机>/<数据库名>
RUCIO_DAEMON：需运行的守护进程名称（如 judge-cleaner、hermes、kronos 等）

4.3 使用配置文件（rucio.cfg）

如需使用完整配置文件而非环境变量，可挂载本地 rucio.cfg 文件（此时环境变量 RUCIO_CFG_* 将被忽略）：

bash
docker run \
  --name=rucio-judge-cleaner \
  -v /本地路径/rucio.cfg:/opt/rucio/etc/rucio.cfg \  # 挂载配置文件
  -e RUCIO_DAEMON=judge-cleaner \  # 指定守护进程名称
  rucio/rucio-daemons

rucio.cfg 用于配置数据库后端和守护进程参数，具体格式参考 Rucio ***文档。

4.4 日志配置

默认日志输出到 stdout 和 stderr，如需写入文件，需设置 RUCIO_ENABLE_LOGS=True 并挂载日志目录：

bash
docker run \
  --name=rucio-judge-cleaner \
  -v /本地路径/rucio.cfg:/opt/rucio/etc/rucio.cfg \
  -v /本地路径/logs:/var/log/rucio \  # 挂载日志目录
  -e RUCIO_DAEMON=judge-cleaner \
  -e RUCIO_ENABLE_LOGS=True \  # 启用文件日志
  rucio/rucio-daemons

日志文件将生成在 /var/log/rucio 下，包含 access_log 和 error_log。

5. 环境变量说明

5.1 必选环境变量

变量名	说明	示例值
`RUCIO_DAEMON`	指定运行的 Rucio 守护进程名称	`judge-cleaner`

5.2 可选环境变量

变量名	说明	默认值
`RUCIO_DAEMON_ARGS`	守护进程的额外命令行参数	无
`RUCIO_ENABLE_LOGS`	是否将日志写入文件（`True` 或 `False`）	`False`（输出到stdout/stderr）
`RUCIO_PRINT_CFG`	启动时是否打印自动生成的 `rucio.cfg` 内容到日志	未设置（默认不打印）

6. RUCIO_CFG 配置参数

可通过环境变量 RUCIO_CFG_* 配置 Rucio，变量名格式为 RUCIO_CFG_<配置节>_<配置项>，对应 rucio.cfg 中的配置。常用参数如下（完整列表见下方）：

环境变量	对应配置项（rucio.cfg）	说明
`RUCIO_CFG_DATABASE_DEFAULT`	`[database] default`	数据库连接串
`RUCIO_CFG_DATABASE_POOL_SIZE`	`[database] pool_size`	数据库连接池大小
`RUCIO_CFG_COMMON_LOGLEVEL`	`[common] loglevel`	日志级别（DEBUG/INFO等）
`RUCIO_CFG_CLIENT_RUCIO_HOST`	`[client] rucio_host`	Rucio 服务地址