cloudpg/xrootd-proxy

XrootD Proxy 镜像文档

镜像概述和主要用途

本镜像提供带有磁盘缓存功能的XrootD代理服务器，用于数据缓存和代理服务。XrootD是一个高性能的分布式数据访问系统，广泛应用于科学计算领域，尤其是高能物理实验。详细信息可参考官方XrootD文档。

核心功能和特性

可用选项

• --nogrid: 避免安装WLCG CAs（网格证书）
• --health_port: 健康检查进程监听端口，类型为整数，默认值为80

重要容器路径

• /data/xrd/: 缓存模式和标准模式下的文件存储位置
• /etc/xrootd/: 配置文件目录
• /var/log/xrootd/cmsd.log: cmsd服务日志
• /var/log/xrootd/xrootd.log: xrootd服务日志

使用场景和适用范围

适用于需要构建XrootD数据缓存和代理服务的场景，尤其适合科学计算环境中对大规模数据进行高效访问和缓存的需求。支持单机部署和基于Docker Compose的本地测试栈部署。

使用方法和配置说明

手动运行

将XrootD配置文件挂载到容器的/etc/xrootd目录，示例命令如下：

bash
# 假设配置文件xrd_test.conf位于当前目录的config子目录下
sudo docker run --rm --privileged -p 32294:32294 -p 31113:31113 -v $PWD/config:/etc/xrootd cloudpg/xrootd-proxy --config /etc/xrootd/xrd_test.conf

注意事项：

• 需暴露配置文件中指定的端口（示例中为32294和31113）
• 文件将存储在/data/xrd目录，建议将此路径挂载到外部存储后端

健康检查

容器提供健康检查接口，通过以下命令访问：

bash
# 响应0表示所有服务正常，响应1表示存在异常
curl <container_ip>/check_health

若返回1，可通过docker logs命令查看崩溃服务的日志详情。

Docker Compose本地栈部署（Origin+Cache+CacheRedirector）

前提条件

需先安装docker-compose。

部署步骤

1. 克隆仓库并进入目录：

   bash
   git clone https://github.com/Cloud-PG/docker-images.git
   cd docker-images/xrd-proxy
   

2. 启动完整栈：

   bash
   /usr/local/bin/docker-compose up -d
   

   该栈包含：

   • 带有配置config/xrd_test_origin.conf的origin服务器
   • 带有配置config/xrd_test.conf的文件缓存服务器
   • 带有配置config/xrd_test-redir.conf的文件缓存重定向器
   • 用于测试的xrd客户端容器

3. 关闭栈：

   bash
   /usr/local/bin/docker-compose down
   

功能测试

bash
# 在origin服务器上创建测试文件
sudo docker exec -ti xrdproxy_origin_1 touch /data/xrd/test.txt

# 通过客户端从监听1094端口的缓存重定向器请求文件
sudo docker exec -ti xrdproxy_client_1 xrdcp -f root://localhost:1094//test.txt /dev/null

# 检查缓存服务器是否成功缓存文件
sudo docker exec -ti xrdproxy_cache_1 ls /data/xrd/
# 预期输出：test.txt  test.txt.cinfo