vsastray/docker-xcache

CMS XCache Docker镜像

镜像概述

本镜像基于OSG XCache镜像构建，为CMS实验提供XCache缓存服务，依赖XRootD软件实现数据联邦场景下Virtual Organization（VO）的高效数据访问与缓存管理。

核心功能

• 支持磁盘使用水位线管理（高/低水位线自动清理）
• 可配置监听端口、内存分配、缓存块大小及预取数量
• 默认集成OSG监控，允许禁用并自定义监控目标
• 支持挂载主机证书、磁盘配置文件及多块缓存磁盘

使用场景

适用于CMS实验中需要高效数据缓存与分发的场景，如分布式数据处理节点、数据存储系统等，帮助提升大规模数据访问的效率与稳定性。

配置说明

启动容器前需准备以下配置：

1. 创建环境变量文件，包含必填参数：
   • XC_ROOTDIR：缓存导出文件的根目录
   • XC_RESOURCENAME：监控报告用的服务器名称
   • XC_SPACE_HIGH_WM：磁盘使用高水位线（触发清理阈值）
   • XC_SPACE_LOW_WM：磁盘使用低水位线（清理停止阈值）
   • XC_PORT：XCache监听的TCP端口
   • XC_RAMSIZE：用于在途数据块的内存量
   • XC_BLOCKSIZE：单个缓存块的大小
   • XC_PREFETCH：单次预取的数据块数量

可选配置：禁用OSG监控

若需自定义监控目标，可在环境变量中添加：

DISABLE_OSG_MONITORING=true

部署示例

使用docker run启动容器（替换尖括号内容）：

bash
docker run --env-file=<环境变量文件路径> \
           --volume <主机证书路径>:/etc/grid-security/hostcert.pem \
           --volume <主机密钥路径>:/etc/grid-security/hostkey.pem \
           --volume <磁盘配置路径>:/etc/xrootd/cache-disks.config \
           --volume <主机缓存磁盘1路径>:<容器挂载点1> \
           ... \
           --volume <主机缓存磁盘N路径>:<容器挂载点N> \
           --publish <主机端口>:<XC_PORT> \
           --hostname <XCache主机名> \
           vsastray/docker-xcache