与Resource Locker项目交互的有用工具
项目描述
与Rlocker项目API交互的有用工具
快速开始
常规安装
pip install rlockertools
设置
git clone https://github.com/red-hat-storage/rlockertools.git
cd rlockertools
python -m venv venv
source venv/bin/activate
pip install ./
rlock --help
用法: rlock [-h] --server-url SERVER_URL --token TOKEN [--release] [--lock] [--resume-on-connection-error] [--signoff SIGNOFF] [--priority PRIORITY] [--search-string SEARCH_STRING] [--link LINK] [--interval INTERVAL] [--attempts ATTEMPTS]
可选参数：-h, --help 显示此帮助信息并退出 --server-url SERVER_URL 资源锁服务器URL --token TOKEN 创建API调用用户的令牌 --release 使用此参数来释放资源 --lock 使用此参数来锁定资源 --resume-on-connection-error 在等待队列状态变为FINISHED的过程中，不想中断队列执行时使用此参数 --signoff SIGNOFF 当lock=True时使用，锁定资源需要签发 --priority PRIORITY 当lock=True时使用，指定资源锁定时的优先级 --search-string SEARCH_STRING 当lock=True时使用，指定可锁定资源的标签或名称 --link LINK 当lock=True时使用，指定锁定资源的CI/CD管道链接 --interval INTERVAL 当lock=True时使用，每次调用检查空闲资源之间的等待秒数 --attempts ATTEMPTS 当lock=True时使用，创建检查空闲资源的API调用次数
## Usage Examples
### To add a queue for locking a resource
```bash
rlock --lock --server-url=your.rlocker.instance.com --token=YOURTOKEN --search-string=nameorlabel --signoff=YOURUNIQUESIGNOFF --priority=3 --interval=15 --attempts=15
释放已锁定的资源（仅按签发过滤）
rlock --release --server-url=your.rlocker.instance.com --token=YOURTOKEN --signoff=YOURUNIQUESIGNOFF
变更日志
[0.3.8] - 2021-03-15
初始构建
[0.3.9] - 2021-07-15
迁移到新仓库 + 错误修复
[0.3.10] - 2021-07-15
修复构建问题
[0.3.11] - 2021-07-19
抑制日志显示在队列返回非200状态码时的安全错误
[0.4] - 2022-04-12
允许在变更队列方法中使用 **datakwargs。这是在队列更改后允许修改数据部分所必需的
[0.4.1] - 2022-04-13
在get_queue方法中显示更多输出，以应对非200状态码的情况
[0.4.2] - 2022-04-17
处理字符串的项赋值问题，应在变更队列方法中修复为字典
[0.4.3] - 2022-04-28
添加日志文件，以便在从rlock入口点执行后跟踪队列ID号。原因：为了进行有关队列的API调用，我们需要将其保存在某个可读位置
[0.4.4] - 2022-06-09
添加对--check参数的支持，该参数将返回给定--search-string是否有可用资源，按标签或名称。提交号：#15
使用示例：rlock --check --search-string=aws-east-2 --token=$token --server-url=$SERVER_URL
[0.4.5] - 2022-07-26
修复队列中数据部分JSON解析问题，这在0.4.2版本中并未完全修复
下载文件
下载您平台的文件。如果您不确定要选择哪个，请了解更多关于安装包的信息。