ivukotic/atlas-xcache

ATLAS XCache Docker镜像文档

镜像概述和主要用途

ATLAS XCache Docker镜像基于https://hub.docker.com/r/opensciencegrid/xcache%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%B8%BAATLAS%E6%95%B0%E6%8D%AE%E8%81%94%E9%82%A6%E5%AE%9E%E7%8E%B0XCache%E6%9C%8D%E5%8A%A1%E3%80%82XCache%E6%98%AF%E5%9F%BA%E4%BA%8EXRootD%E8%BD%AF%E4%BB%B6%E7%9A%84%E7%BC%93%E5%AD%98%E6%9C%8D%E5%8A%A1%EF%BC%8C%E7%94%A8%E4%BA%8E%E4%B8%BA%E4%B8%80%E4%B8%AA%E6%88%96%E5%A4%9A%E4%B8%AA%E8%99%9A%E6%8B%9F%E7%BB%84%E7%BB%87%EF%BC%88VO%EF%BC%89%E7%9A%84%E6%95%B0%E6%8D%AE%E8%81%94%E9%82%A6%E6%8F%90%E4%BE%9B%E7%BC%93%E5%AD%98%E6%94%AF%E6%8C%81%EF%BC%8C%E6%8F%90%E5%8D%87%E6%95%B0%E6%8D%AE%E8%AE%BF%E9%97%AE%E6%95%88%E7%8E%87%E3%80%82%E6%9C%AC%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E8%AF%A6%E7%BB%86%E8%AF%B4%E6%98%8E%E5%A6%82%E4%BD%95%E9%85%8D%E7%BD%AE%E5%92%8C%E5%90%AF%E5%8A%A8ATLAS XCache容器。

核心功能和特性

• 基于XRootD软件实现数据联邦缓存服务，专为ATLAS数据联邦优化
• 支持通过环境变量配置缓存关键参数，包括资源名称、磁盘使用水位、端口、内存大小、块大小和预取块数
• 默认集成OSG监控功能，可上报数据联邦健康状态至OSG，支持禁用OSG监控以自定义监控目标
• 支持挂载多个缓存磁盘，满足大规模缓存存储需求
• 依赖网格安全证书和密钥进行安全配置

使用场景和适用范围

适用于需要为ATLAS数据联邦提供缓存服务的场景，帮助服务一个或多个虚拟组织（VO）的数据访问需求，尤其适合需要提升数据访问速度、优化数据联邦性能的环境。

配置说明

必要环境变量配置

启动容器前，需创建环境变量配置文件，包含以下必填环境变量及对应值：

• XC_RESOURCENAME：用于监控和报告的服务器名称
• XC_SPACE_HIGH_WM：磁盘使用高水位线，当使用率超过此值时，缓存会删除数据直至达到低水位线
• XC_SPACE_LOW_WM：磁盘使用低水位线，当使用率超过高水位线时，缓存会删除数据直至达到此值
• XC_PORT：XCache监听的TCP端口
• XC_RAMSIZE：用于处理中块的内存用量
• XC_BLOCKSIZE：缓存中块的大小
• XC_PREFETCH：一次从文件预取的块数

禁用OSG监控（可选）

默认情况下，XCache会向OSG上报监控信息，以便OSG人员监控数据联邦健康状态。如需将监控信息上报至其他目标，可通过设置以下环境变量禁用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 <主机缓存磁盘1路径>:<容器挂载点1> \
             ... \
             --volume <主机缓存磁盘N路径>:<容器挂载点N> \
             --publish <主机端口>:<XC_PORT> \
             --hostname <XCACHE主机名> \
             opensciencegrid/atlas-xcache:development

参数说明：

• --env-file：指定包含环境变量配置的文件路径
• --volume：挂载主机文件/目录至容器，包括：
  • 主机网格安全证书（hostcert.pem）和密钥（hostkey.pem），挂载至容器/etc/grid-security/目录
  • 一个或多个主机缓存磁盘路径，分别挂载至容器的对应挂载点（如<HOST PATH TO CACHE DISK 1>:<CONTAINER MOUNT POINT 1>）
• --publish：将主机端口映射至容器内XC_PORT端口
• --hostname：指定XCache主机名
• 镜像标签：使用opensciencegrid/atlas-xcache:development（开发版）