projectescape/rucio-client

rucio-client-container

镜像概述和主要用途

为ESCAPE虚拟组织(VO)启用的Rucio客户端容器。基础镜像可在https://github.com/rucio/containers/tree/master/clients%E8%8E%B7%E5%8F%96%EF%BC%8CESCAPE%E7%89%B9%E5%AE%9A%E9%95%9C%E5%83%8F%E5%88%99%E4%BD%8D%E4%BA%8Ehttps://github.com/ESCAPE-WP2/Rucio-Client-Containers/tree/master/rucio-client-container%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E4%BA%86%E5%9C%A8ESCAPE VO环境中使用Rucio客户端的完整功能。

核心功能和特性

• 支持ESCAPE VO环境下的Rucio客户端操作
• 提供多种认证机制：X.509证书认证、X.509代理认证、用户名密码认证
• 默认支持Python 3环境，可选Python 2版本
• 兼容Docker和Singularity容器平台

构建镜像

默认Python 3版本

bash
$ make latest

Python 2版本

bash
$ make py2

使用方法和配置说明

使用X.509认证运行

通过环境变量配置

bash
$ docker run -e RUCIO_CFG_ACCOUNT=<myrucioaccount> -v /path/to/client.crt:/opt/rucio/etc/client.crt -v /path/to/client.key:/opt/rucio/etc/client.key -it --name=rucio-client rucio-client

参数说明：

• -e RUCIO_CFG_ACCOUNT: 指定Rucio账户
• -v /path/to/client.crt:/opt/rucio/etc/client.crt: 挂载X.509证书
• -v /path/to/client.key:/opt/rucio/etc/client.key: 挂载X.509密钥

使用X.509代理

bash
$ voms-proxy-init
$ docker run -e RUCIO_CFG_ACCOUNT=<myrucioaccount> -e RUCIO_CFG_AUTH_TYPE=x509_proxy -e RUCIO_CFG_CLIENT_X509_PROXY=/opt/proxy/x509up_uNNNN -v /tmp:/opt/proxy -it --name=rucio-client rucio-client

参数说明：

• voms-proxy-init: 初始化VOMS代理
• -e RUCIO_CFG_AUTH_TYPE=x509_proxy: 指定认证类型为X.509代理
• -e RUCIO_CFG_CLIENT_X509_PROXY: 指定代理文件路径
• -v /tmp:/opt/proxy: 挂载本地临时目录以访问代理文件

使用自定义rucio.cfg

bash
$ docker run -e RUCIO_CFG_ACCOUNT=<myrucioaccount> -v /path/to/rucio.cfg:/opt/rucio/etc/rucio.cfg -v /path/to/client.crt:/opt/rucio/etc/client.crt -v /path/to/client.key:/opt/rucio/etc/client.key -it --name=rucio-client rucio-client

说明：挂载本地自定义配置文件rucio.cfg到容器内/opt/rucio/etc路径，同时挂载证书和密钥文件。

使用用户名密码认证运行

bash
$ docker run -e RUCIO_CFG_ACCOUNT=<myrucioaccount> -e RUCIO_CFG_AUTH_TYPE=userpass -e RUCIO_CFG_USERNAME=<myrucioname> -e RUCIO_CFG_PASSWORD=<myruciopassword> -it --name=rucio-client rucio-client

参数说明：

• -e RUCIO_CFG_AUTH_TYPE=userpass: 指定认证类型为用户名密码
• -e RUCIO_CFG_USERNAME: Rucio用户名
• -e RUCIO_CFG_PASSWORD: Rucio密码

在Singularity中运行

构建Singularity镜像

bash
singularity build rucio-cli.simg docker://projectescape/rucio-client:latest

运行Singularity容器

bash
mkdir -p ${HOME}/.rucio
export RUCIO_CFG_ACCOUNT=<my_account>
singularity run -B ${HOME}/.rucio/:/opt/rucio/etc -B ${HOME}/.globus/client.crt:/opt/rucio/etc/client.crt -B ${HOME}/.globus/client.key:/opt/rucio/etc/client.key rucio-cli.simg

说明：如需重置配置，可删除${HOME}/.rucio/rucio.cfg文件以初始化新配置。