riga/law

law Docker镜像文档

镜像概述和主要用途

law是一个基于luigi构建的工具，用于创建复杂和大规模任务工作流。本Docker镜像为law提供了便捷的运行环境，基于CentOS 7，包含law及其所有依赖（如luigi、six、gfal2等），支持多种Python版本，适用于快速部署和测试law工作流。

核心功能和特性

• 多Python版本支持：提供Python 2.7、3.7、3.8版本的镜像，满足不同环境需求。
• 完整依赖集成：预装law运行所需的所有依赖，包括luigi、six、gfal2及gfal2-python，无需额外配置。
• 多场景兼容性：支持通过Docker容器直接运行示例工作流，快速体验law的核心功能。
• 环境一致性：基于CentOS 7构建，确保不同环境下的运行一致性，避免依赖冲突。

使用场景和适用范围

• 快速上手law：无需手动安装依赖，通过Docker镜像直接启动并使用law。
• 工作流测试：在隔离环境中测试复杂任务工作流，验证远程目标（如WebDAV、Dropbox、SFTP）和批处理系统（如HTCondor、LSF）的集成。
• 示例演示：运行内置示例（如loremipsum、workflows、dropbox_targets等），学习law的使用方法。
• 多Python版本测试：在不同Python版本环境中验证工作流兼容性。

详细使用方法和配置说明

Docker镜像获取与运行

基本运行命令

通过以下命令启动最新版本的law Docker容器：

bash
docker run -ti docker.xuanyuan.run/riga/law:latest

该命令将以交互模式启动容器，提供bash终端，可直接使用law命令。

标签说明

Docker镜像提供以下标签，对应不同Python版本：

• latest、py3、py38：Python 3.8.2
• py37：Python 3.7.6
• py2、py27：Python 2.7.5

例如，运行Python 3.7版本：

bash
docker run -ti docker.xuanyuan.run/riga/law:py37

示例工作流运行

law提供多种示例工作流，可通过riga/law:example镜像运行。命令格式：

bash
docker run -ti docker.xuanyuan.run/riga/law:example <example_name>

可用示例列表

• loremipsum：law的"hello world"示例，基础工作流演示。
• workflows：law工作流示例集合。
• dropbox_targets：使用Dropbox存储目标的示例。
• wlcg_targets：使用WLCG存储元素（dCache、EOS等）的目标示例（开发中）。
• htcondor_at_vispa：在VISPA服务上运行HTCondor工作流的示例。
• htcondor_at_cern：在CERN批处理基础设施上运行HTCondor工作流的示例。
• grid_at_cern：在WLCG上运行作业并存储数据的工作流示例。
• lsf_at_cern：在CERN批处理基础设施上运行LSF工作流的示例。
• docker_sandboxes：使用Docker进行环境沙箱的示例（开发中）。
• singularity_sandboxes：使用Singularity进行环境沙箱的示例（开发中）。
• subshell_sandboxes：使用子shell进行环境沙箱的示例（开发中）。
• parallel_optimization：使用scikit-optimize进行并行优化的示例。
• notifications：Slack和***任务状态通知演示。
• CMS Single Top Analysis：使用law的简单物理分析示例。

命令行自动补全配置

Bash

在bash中启用自动补全：

bash
source "$( law completion )"

Zsh

1. 首先确保已启用补全脚本，运行compinstall并按照提示配置：

bash
autoload -Uz compinstall && compinstall

2. 配置完成后，~/.zshrc中应包含以下内容：

bash
# The following lines were added by compinstall
zstyle :compinstall filename '~/.zshrc'

autoload -Uz compinit
compinit
# End of lines added by compinstall

3. 启用law自动补全：

bash
source "$( law completion )"

开发与支持

• 源码托管：https://github.com/riga/law
• 问题反馈：通过https://github.com/riga/law/issues%E6%8A%A5%E5%91%8A%E9%97%AE%E9%A2%98%E3%80%81%E6%8F%90%E9%97%AE%E6%88%96%E8%AF%B7%E6%B1%82%E5%8A%9F%E8%83%BD
• 文档：http://law.readthedocs.io/en/latest
• CERN使用指南：https://github.com/riga/law/wiki/Usage-at-CERN
• 配置示例：https://github.com/riga/law/tree/master/law.cfg.example