opensciencegrid/atlas-xcache

ATLAS XCache Docker镜像

镜像源码地址：https://github.com/opensciencegrid/docker-xcache/tree/master/atlas-xcache

XCache基于XRootD软件，为服务一个或多个虚拟组织（VO）的数据联邦提供缓存服务。本镜像基于https://hub.docker.com/r/opensciencegrid/xcache%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%AE%9E%E7%8E%B0%E4%BA%86ATLAS%E6%95%B0%E6%8D%AE%E8%81%94%E9%82%A6%E7%9A%84XCache%E5%8A%9F%E8%83%BD%E3%80%82

本文档介绍如何配置和启动ATLAS XCache容器。

配置

启动容器前，需在Docker主机上编写以下配置：

1. 创建包含XCache所需环境变量及值的文件，必填变量如下：

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

2. 创建cache-disks.config文件，包含将在容器内挂载的磁盘路径。

禁用OSG监控（可选）

默认情况下，XCache会向OSG报告监控信息，以便OSG工作人员监控数据联邦的健康状态。若需将监控信息报告至其他目标，可通过在环境变量配置中设置以下内容禁用OSG监控：

DISABLE_OSG_MONITORING=true

运行容器

使用docker run命令运行容器，将尖括号中的文本替换为实际值：

$ 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主机名> \
             opensciencegrid/atlas-xcache:development