rucio/rucio-ui

Rucio - 科学数据管理（WebUI容器）

镜像概述和主要用途

Rucio是一个科学数据管理软件框架，提供组织、管理和访问大量科学数据的功能，支持自定义策略。数据可分布在全球不同位置和异构数据中心，整合不同存储和网络技术为单一联邦实体。本镜像为Rucio的WebUI容器，作为Web前端界面连接Rucio服务器，支持MySQL、PostgreSQL、Oracle和SQLite数据库后端，适用于科学数据的分布式管理场景。

核心功能和特性

• 分布式数据管理：支持组织、管理和访问全球分布式存储的大规模科学数据
• 高级数据功能：提供分布式数据恢复、自适应复制等高级特性
• 高扩展性架构：模块化、可扩展设计，满足不断增长的数据管理需求
• 多数据库支持：兼容MySQL、PostgreSQL、Oracle和SQLite等多种数据库后端
• 灵活配置：通过环境变量和配置文件自定义系统行为，适应不同部署需求

使用场景和适用范围

最初为高能物理实验ATLAS开发，现广泛应用于LHC实验及其他科学社区，特别适合需要管理PB级以上分布式科学数据的场景，如粒子物理、天文学、气候科学等领域的大型科研项目。

详细使用方法和配置说明

快速开始

以下命令可启动最小配置的WebUI实例：

bash
docker run \
  --name=rucio-webui \
  -v /tmp/ca.pem:/etc/grid-security/ca.pem \
  -v /tmp/hostcert.pem:/etc/grid-security/hostcert.pem \
  -v /tmp/hostkey.pem:/etc/grid-security/hostkey.pem \
  -v /tmp/rucio.cfg:/opt/rucio/etc/rucio.cfg \
  -p 443:443 \
  -e RUCIO_PROXY="server.rucio" \
  -e RUCIO_AUTH_PROXY="auth.rucio" \
  rucio/rucio-ui

参数说明：

• 挂载CA证书、主机证书和密钥到容器的/etc/grid-security/目录（SSL必需）
• 挂载rucio.cfg配置文件到/opt/rucio/etc/rucio.cfg（需与认证服务器指向同一数据库）
• 映射容器443端口到主机，提供HTTPS访问
• RUCIO_PROXY和RUCIO_AUTH_PROXY分别指定Rucio服务器和认证服务器端点

环境变量配置

通过docker run的-e参数可配置以下环境变量，自定义WebUI行为：

核心连接参数

• RUCIO_PROXY：Rucio服务器访问地址，用于httpd代理通信（解决跨域问题）
• RUCIO_PROXY_SCHEME：代理URL协议方案，默认"https"
• RUCIO_AUTH_PROXY：认证服务器访问地址（可与主服务器不同）
• RUCIO_AUTH_PROXY_SCHEME：认证服务器协议方案，默认"https"

日志配置

• RUCIO_ENABLE_LOGFILE：设为True时日志写入文件（默认输出到stdout/stderr）
• RUCIO_HTTPD_LOG_DIR：日志文件存储目录（默认/var/log/httpd）
• RUCIO_LOG_LEVEL：日志级别，默认"info"
• RUCIO_LOG_FORMAT：日志格式，默认值：%h\t%t\t%{X-Rucio-Forwarded-For}i\t%T\t%D\t\"%{X-Rucio-Auth-Token}i\"\t%{X-Rucio-RequestId}i\t%{X-Rucio-Client-Ref}i\t\"%r\"\t%>s\t%b

Apache配置参数

• RUCIO_HOSTNAME：Apache配置中的服务器名称
• RUCIO_SERVER_ADMIN：Apache配置中的服务器管理员
• RUCIO_HTTPD_MPM_MODE：Apache MPM模式，默认"event"
• RUCIO_CA_PATH：SSL证书路径，用于配置SSLCACertificatePath和SSLCARevocationPath

RUCIO_CFG配置参数

环境变量可生成rucio.cfg配置文件，变量名格式为RUCIO_CFG_<SECTION>_<KEY>，例如database部分的default值对应RUCIO_CFG_DATABASE_DEFAULT。常用配置变量包括：

• 通用配置：RUCIO_CFG_COMMON_LOGDIR、RUCIO_CFG_COMMON_LOGLEVEL、RUCIO_CFG_COMMON_MULTI_VO
• 数据库配置：RUCIO_CFG_DATABASE_DEFAULT、RUCIO_CFG_DATABASE_POOL_SIZE、RUCIO_CFG_DATABASE_SCHEMA
• 监控配置：RUCIO_CFG_MONITOR_CARBON_SERVER、RUCIO_CFG_MONITOR_CARBON_PORT
• WebUI配置：RUCIO_CFG_WEBUI_USERCERT

完整配置变量列表见下文"可用环境变量"部分。

文档和支持

官方文档

• 最新文档：readthedocs
• 官方网站：[***]

开发者指南

贡献代码请参考https://github.com/rucio/rucio/blob/master/CONTRIBUTING.rst

支持渠道

• 邮件列表：***
• Slack支持频道：[***]

可用RUCIO_CFG环境变量完整列表

RUCIO_CFG_COMMON_LOGDIR
RUCIO_CFG_COMMON_LOGLEVEL
RUCIO_CFG_COMMON_MAILTEMPLATEDIR
RUCIO_CFG_COMMON_MULTI_VO
RUCIO_CFG_DATABASE_DEFAULT
RUCIO_CFG_DATABASE_ECHO
RUCIO_CFG_DATABASE_MAX_OVERFLOW
RUCIO_CFG_DATABASE_POOL_RECYCLE
RUCIO_CFG_DATABASE_POOL_RESET_ON_RETURN
RUCIO_CFG_DATABASE_POOL_SIZE
RUCIO_CFG_DATABASE_POOL_TIMEOUT
RUCIO_CFG_DATABASE_POWUSERACCOUNT
RUCIO_CFG_DATABASE_POWUSERPASSWORD
RUCIO_CFG_DATABASE_SCHEMA
RUCIO_CFG_MONITOR_CARBON_PORT
RUCIO_CFG_MONITOR_CARBON_SERVER
RUCIO_CFG_MONITOR_USER_SCOPE
RUCIO_CFG_NONGRID_TRACE_BROKERS
RUCIO_CFG_NONGRID_TRACE_PASSWORD
RUCIO_CFG_NONGRID_TRACE_PORT
RUCIO_CFG_NONGRID_TRACE_TOPIC
RUCIO_CFG_NONGRID_TRACE_TRACEDIR
RUCIO_CFG_NONGRID_TRACE_USERNAME
RUCIO_CFG_OIDC_ADMIN_ISSUER
RUCIO_CFG_OIDC_IDPSECRETS
RUCIO_CFG_POLICY_LFN2PFN_ALGORITHM_DEFAULT
RUCIO_CFG_POLICY_LFN2PFN_MODULE
RUCIO_CFG_POLICY_PACKAGE
RUCIO_CFG_POLICY_PERMISSION
RUCIO_CFG_POLICY_SCHEMA
RUCIO_CFG_POLICY_SUPPORT
RUCIO_CFG_POLICY_SUPPORT_RUCIO
RUCIO_CFG_TRACE_BROKERS
RUCIO_CFG_TRACE_PASSWORD
RUCIO_CFG_TRACE_PORT
RUCIO_CFG_TRACE_TOPIC
RUCIO_CFG_TRACE_TRACEDIR
RUCIO_CFG_TRACE_USERNAME
RUCIO_CFG_WEBUI_USERCERT