FABRIC Python客户端库和CLI
项目描述
FABRIC TESTBED用户库和CLI
Fabric用户CLI用于实验
概述
此软件包支持面向用户的API以及CLI。
- 令牌：令牌管理
- 切片：切片管理
- 薄片：薄片管理
- 资源：资源管理
CLI命令
| 命令 | 子命令 | 操作 | 输入 | 输出 |
|---|---|---|---|---|
tokens |
issue |
使用projectId和scope发布令牌 | projectId 项目ID，scope 范围 |
指向凭证管理器以生成令牌 |
token |
refresh |
刷新令牌 | projectId 项目ID，scope 范围，refreshtoken 刷新令牌 |
返回新的身份和刷新令牌 |
token |
revoke |
撤销令牌 | refreshtoken 刷新令牌 |
成功或失败状态 |
slices |
query |
查询用户切片 | idtoken 身份令牌，refreshtoken 刷新令牌，projectId 项目ID，scope 范围，sliceid 切片ID |
切片列表或表示由切片ID识别的切片的Graph ML |
slices |
create |
创建用户切片 | idtoken 身份令牌，refreshtoken 刷新令牌，projectId 项目 ID，scope 范围，slicename 切片名称，slicegraph 切片图 |
为切片创建的切片列表 |
slices |
删除 |
删除用户切片 | idtoken 身份令牌，refreshtoken 刷新令牌，projectId 项目ID，scope 范围，sliceid 切片ID |
成功或失败状态 |
切片 |
query |
查询用户切片 | idtoken 身份令牌，refreshtoken 刷新令牌，projectId 项目 ID，scope 范围，sliceid 切片 ID，sliverid 切片 ID |
根据切片 ID 或切片 ID 确定的切片的资源列表 |
资源 |
query |
查询资源 | idtoken 身份令牌，refreshtoken 刷新令牌，projectId 项目 ID，scope 范围 |
表示可用资源的图 ML |
API
SliceManager 类实现了支持上述操作的 API。请参阅下面的使用示例。
需求
Python 3.9+
安装
有多种安装选项。对于 CF 开发，建议的方法是从 GitHub MASTER 分支安装
$ mkvirtualenv fabrictestbed
$ workon fabrictestbed
$ pip install git+https://github.com/fabric-testbed/fabric-cli.git
用于包含在工具中等，请使用 PyPi
$ mkvirtualenv fabrictestbed
$ workon fabrictestbed
$ pip install fabrictestbed
上述安装示例的先决条件
确保以下已安装
virtualenvvirtualenvwrapper
注意：任何虚拟环境工具（venv、virtualenv 或 virtualenvwrapper）都应适用。
使用（API）
用户 API 支持令牌和编排命令。请参阅以下 Jupyter Notebooks 中的示例：此处。
使用（CLI）
配置
用户 CLI 期望用户设置以下环境变量
export FABRIC_ORCHESTRATOR_HOST=orchestrator.fabric-testbed.net
export FABRIC_CREDMGR_HOST=cm.fabric-testbed.net
export FABRIC_TOKEN_LOCATION=<location of the token file downloaded from the Portal>
export FABRIC_PROJECT_ID=<Project Id of the project for which resources are being provisioned>
或者，用户可以将这些作为参数传递给命令。
要启用 CLI 自动完成，请将以下行添加到您的 ~/.bashrc
eval "$(_FABRIC_CLI_COMPLETE=source_bash fabric-cli)"
打开一个新的 shell 以启用完成。或者，在您的当前 shell 中直接运行 eval 命令以临时启用它。
用户 CLI 支持令牌和编排命令
(usercli) $ fabric-cli
Usage: fabric-cli [OPTIONS] COMMAND [ARGS]...
Options:
-v, --verbose
--help Show this message and exit.
Commands:
resources Resource management (set $FABRIC_ORCHESTRATOR_HOST to the...
slices Slice management (set $FABRIC_ORCHESTRATOR_HOST to the...
slivers Sliver management (set $FABRIC_ORCHESTRATOR_HOST to the...
tokens Token management (set $FABRIC_CREDMGR_HOST to the Credential...
令牌管理命令
下面是可以支持的令牌命令列表
(usercli) $ fabric-cli tokens
Usage: fabric-cli tokens [OPTIONS] COMMAND [ARGS]...
Token management (set $FABRIC_CREDMGR_HOST to the Credential Manager
Server)
Options:
--help Show this message and exit.
Commands:
issue Issue token with projectId and scope
refresh Refresh token
revoke Revoke token
资源管理命令
下面是可以支持的资源命令列表
$ fabric-cli resources
Usage: fabric-cli resources [OPTIONS] COMMAND [ARGS]...
Query Resources (set $FABRIC_ORCHESTRATOR_HOST to the Control Framework
Orchestrator)
Options:
--help Show this message and exit.
Commands:
query issue token with projectId and scope
切片管理命令
(usercli) $ fabric-cli slices
Usage: fabric-cli slices [OPTIONS] COMMAND [ARGS]...
Slice management (set $FABRIC_ORCHESTRATOR_HOST to the Orchestrator)
Options:
--help Show this message and exit.
Commands:
create Create user slice
delete Delete user slice
query Query user slice(s)
切片管理命令
(usercli) $ fabric-cli slivers
Usage: fabric-cli slivers [OPTIONS] COMMAND [ARGS]...
Sliver management (set $FABRIC_ORCHESTRATOR_HOST to the Orchestrator)
Options:
--help Show this message and exit.
Commands:
query Query user slice sliver(s)
下载文件
下载适用于您平台的文件。如果您不确定选择哪个，请了解更多关于安装包的信息。
源代码分发
fabrictestbed-1.7.8.tar.gz (24.3 kB 查看散列值)
构建分发
fabrictestbed-1.7.8-py3-none-any.whl (32.3 kB 查看哈希值)
关闭
fabrichtestbed-1.7.8.tar.gz 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | e5021bc76c2b9bde38ab4168626353a5c07fbd4dfbd84d7fa3bef0f9c6e4737d |
|
| MD5 | 42793830e84ab54c79a1226213a9a928 |
|
| BLAKE2b-256 | 2fcf94b88115fa93b4b98940acfb1f7f390df8e63eafe3e7042432dbd0a0b28a |
关闭
fabrichtestbed-1.7.8-py3-none-any.whl 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | e402480537fc88cf013f4e2158acd37fbd5f578b8dde46ea29d16c317ba075cd |
|
| MD5 | e4a41176c9a6fb485caf8898a1b5ef94 |
|
| BLAKE2b-256 | 4cbcdf123cce418dc6bfad2d1d8cdc23a77ddb43e440c6e9fe3073ca33e784bf |
