cloudpg/cachingondemand

镜像概述

本镜像基于XrootD构建，提供按需缓存解决方案，用于高效管理文件缓存、数据传输重定向及相关服务配置，支持健康检查、自定义配置文件等功能，可快速部署本地或分布式缓存系统。

核心功能

1. 配置选项：
   • --nogrid：跳过WLCG CA安装
   • --health_port：健康检查端口（默认80，类型为整数）
   • --config：指定XrootD配置文件路径
2. 关键路径：
   • /data/xrd/：缓存和标准模式下的文件存储位置
   • /etc/xrootd/：配置文件目录
   • /var/log/xrootd/cmsd.log：cmsd服务日志
   • /var/log/xrootd/xrootd.log：xrootd服务日志
3. 健康检查：通过curl <容器IP>/check_health获取服务状态（响应0正常，1异常）

使用场景

• 科学数据共享与传输加速
• 分布式缓存系统搭建
• 数据存储节点的缓存管理

配置说明与部署示例

手动运行

将XrootD配置文件放置于本地$PWD/config目录，挂载到容器/etc/xrootd：

bash
# 假设本地配置文件为$PWD/config/xrd_test.conf
sudo docker run --rm --privileged -p 32294:32294 -p 31113:31113 -v $PWD/config:/etc/xrootd cloudpg/cachingondemand --config /etc/xrootd/xrd_test.conf

注意：需暴露配置文件中指定的端口（如示例中的32294、31113），并可挂载存储到/data/xrd以持久化缓存文件。

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

1. 安装Docker Compose（参考https://docs.docker.com/compose/install/#install-compose%EF%BC%89
2. 克隆仓库并启动栈：

bash
git clone https://github.com/Cloud-PG/cachingondemand.git
cd cachingondemand/docker
/usr/local/bin/docker-compose up -d

3. 关闭栈：

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

功能测试

bash
# 在远程主机放置测试文件
sudo docker exec -ti docker_client_1 sh -c "echo \"This is my file\" > test.txt && xrdcp test.txt root://docker_origin_1:1194//test.txt"
# 从缓存重定向器请求文件（监听端口1094）
sudo docker exec -ti docker_client_1 xrdcp -f -d3 root://docker_redirector_1//test.txt remote_test.txt
# 检查缓存服务器上的文件
sudo docker exec -ti docker_cache_1 ls /data/xrd/
# 预期输出：test.txt  test.txt.cinfo