rucio/jupyterlab

Rucio JupyterLab Extension

镜像概述和主要用途

这是一个JupyterLab扩展，与https://github.com/rucio/rucio%E9%9B%86%E6%88%90%EF%BC%8C%E5%85%81%E8%AE%B8%E7%94%A8%E6%88%B7%E7%9B%B4%E6%8E%A5%E4%BB%8EJupyterLab%E7%95%8C%E9%9D%A2%E8%AE%BF%E9%97%AERucio%E7%9A%84%E9%83%A8%E5%88%86%E5%8A%9F%E8%83%BD%E3%80%82%E8%AF%A5%E6%89%A9%E5%B1%95%E7%94%B1%E5%90%8D%E4%B8%BA%60rucio_jupyterlab%60%E7%9A%84Python%E5%8C%85%EF%BC%88%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%89%A9%E5%B1%95%EF%BC%89%E5%92%8C%E5%90%8D%E4%B8%BA%60rucio-jupyterlab%60%E7%9A%84NPM%E5%8C%85%EF%BC%88%E5%89%8D%E7%AB%AF%E6%89%A9%E5%B1%95%EF%BC%89%E7%BB%84%E6%88%90%E3%80%82

核心功能和特性

• 与Rucio科学数据管理系统深度集成
• 提供服务器端（Python）和前端（NPM）双重扩展组件
• 支持Replica和Download两种运行模式
• 需JupyterLab 3.0及以上版本环境

要求

• JupyterLab >= 3.0
• NodeJS（用于扩展安装）
• 额外依赖（根据运行模式）：
  • Download模式：gfal2库（可通过EPEL或conda-forge获取）
  • 身份认证工具：grid-proxy-init或voms-proxy-init（通过安装voms-clients-java获取）

安装

基础安装

bash
pip install rucio-jupyterlab

额外依赖安装

Debian/Ubuntu系统

bash
apt install voms-clients-java
conda install -c conda-forge python-gfal2

RHEL/CentOS系统

bash
yum install epel-release
yum install gfal2-all gfal2-python voms-clients-java

安装完成后，重启JupyterLab实例以加载服务器扩展。

配置

详见CONFIGURATION.md

贡献

如需贡献或从源码构建扩展，详见CONTRIBUTING.md

使用Docker快速部署

本仓库提供基于https://hub.docker.com/r/jupyter/scipy-notebook%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E5%B7%B2%E9%A2%84%E8%A3%85%E8%AF%A5%E6%89%A9%E5%B1%95%E3%80%82

Replica模式

bash
docker run -d -p 8888:8888 \
    -e RUCIO_MODE=replica \
    -e RUCIO_WILDCARD_ENABLED=<true = 1, false = 0> \
    -e RUCIO_BASE_URL=<Rucio基础URL> \
    -e RUCIO_AUTH_URL=<Rucio认证URL（如有）> \
    -e RUCIO_DESTINATION_RSE=<目标RSE> \
    -e RUCIO_DISPLAY_NAME=<实例显示名称> \
    -e RUCIO_NAME=<实例名称> \
    -e RUCIO_SITE_NAME=ROAMING \
    -e RUCIO_VO=def \
    -e RUCIO_PATH_BEGINS_AT=<路径起始位置> \
    -e RUCIO_RSE_MOUNT_PATH=<挂载路径> \
    -v <主机文件夹>:<容器文件夹> \
    rucio/jupyterlab:latest

• <主机文件夹>：主机中通过FUSE挂载到Rucio存储元素的文件夹
• <容器文件夹>：notebook可访问的、挂载到主机文件夹的容器内文件夹

Download模式

bash
docker run -d -p 8888:8888 \
    -e RUCIO_MODE=download \
    -e RUCIO_WILDCARD_ENABLED=<true = 1, false = 0> \
    -e RUCIO_BASE_URL=<Rucio基础URL> \
    -e RUCIO_AUTH_URL=<Rucio认证URL（如有）> \
    -e RUCIO_DISPLAY_NAME=<实例显示名称> \
    -e RUCIO_NAME=<实例名称> \
    -e RUCIO_SITE_NAME=ROAMING \
    -e RUCIO_VO=def \
    -e RUCIO_VOMS_ENABLED=<true = 1, false = 0> \
    -e RUCIO_VOMS_VOMSES_PATH=<vomses文件路径（可选）> \
    -e RUCIO_VOMS_CERTDIR_PATH=<证书目录路径（可选）> \
    -e RUCIO_VOMS_VOMSDIR_PATH=<voms目录路径（可选）> \
    -e RUCIO_CA_CERT=/certs/rucio_ca.pem \
    -v <Rucio CA PEM文件路径>:/certs/rucio_ca.pem \
    rucio/jupyterlab:latest

参数详情请参考配置指南。

故障排除

若前端扩展已显示但无法正常工作，检查服务器扩展是否启用：

bash
jupyter serverextension list

若服务器扩展已安装启用但未显示前端，检查前端扩展是否安装：

bash
jupyter labextension list

若已安装，尝试：

bash
jupyter lab clean
jupyter lab build