跳到主要内容

CLI

bc-cli 可以用来管理账户信息，管理存证，以及查看汲取中构成区块链的多种资源，包括不限于联盟，网络等。 该工具包含 create, delete, get 三个主要命令, 用来操作 account, depository 等资源。

快速开始​

设置配置文件​

提示

CLI使用时可通过 --config 指定配置文件，默认位置为 ~/.bestchains/config.yaml

配置文件如下：

auth:
  clientid: bff-client
  clientsecret: 61324af0-1234-4f61-b110-ef57013267d6
  enable: true
  expiry: 1684217088
  idtoken: eyJhbGciOiJSUzI1NiIsImtpZCI6IjkxYzliZTRlMmExNzM4ZmY2OTI2NWYwNjNlZjNiMTUxNmJhMjliY2IifQ.eyJpc3MiOiJodHRwczovL3BvcnRhbC4xNzIuMjIuOTYuMjA5Lm5pcC5pby9vaWRjIiwic3ViIjoiQ2doaWFuZHpkMkZ1WnhJR2F6aHpZM0prIiwiYXVkIjoiYmZmLWNsaWVudCIsImV4cCI6MTY4NDIxNjg2MywiaWF0IjoxNjg0MTMwNDYzLCJhdF9oYXNoIjoiaHN4QmdMR1I3R09STDIway1vZS1SQSIsImNfaGFzaCI6IlppNHBKMExfaXZQNGhRUGdaRkJrTXciLCJlbWFpbCI6ImFkbWluQHRlbnhjbG91ZC5jb20iLCJlbWFpbF92ZXJpZmllZCI6dHJ1ZSwiZ3JvdXBzIjpbImlhbS50ZW54Y2xvdWQuY29tIiwib2JzZXZhYmlsaXR5IiwicmVzb3VyY2UtcmVhZGVyIiwiYmVzdGNoYWlucyJdLCJuYW1lIjoiYmp3c3dhbmciLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJiandzd2FuZyIsInBob25lIjoiIiwidXNlcmlkIjoiYmp3c3dhbmcifQ.e_EXejiIoqsrfa1YCMKF1RnHWT3pL0gzdAd9a2nC8I67CQfNRdGy0HOEnH_UVZlS8alkweYRx85qG5hF16Z7G7XvwWgNXDehQruy4UbMgqX1kcPkwpFNxzeQSbPL9YerjN7Q4F5rjOC_Ms365pVOqAlWp-Omk0j0AlQRadUE8HRHudXOcIg-ZuTvbAXj5J5yYyOswphT7QistJnBazoRxXVDEvWcXdFbaIfv1SaXsxk3T1I7cqlrap0Xc4x99OffH3DKSZPAGBBW6kZ_b-xiXQQPKG-bgxL4jYCTE93qFlyUovSqFmZj_2OyNkYaDoujS9-xUvOCyY63sZVDRXkNuw
  issuerurl: https://portal.172.22.96.209.nip.io/oidc
  refreshtoken: ChlzNWd1NW42c2E0a2tweG9ieGRpeXlvazNuEhlzdWdrbzJkaW14ZjJmcnN3NHBua3VwbDZr
cluster:
  certificateauthority: ""
  disablecompression: false
  insecureskiptlsverify: false
  locationoforigin: ""
  proxyurl: ""
  server: https://172.22.96.146:9443
  tlsservername: ""
saas:
  depository:
    server: https://bc-saas.172.22.96.209.nip.io

配置详解:

  • auth 为认证相关信息：
    1. enable：是否启用认证，布尔值，在服务器端启用认证时，CLI 不启用认证，访问请求将会失败，而服务器端没有启用认证时，CLI 启用认证时，认证参数将被服务器端忽略。
    2. expiry：(不建议更改) IDToken 的过期时间 unix 时间戳，一般不需要手动配置，认证完成后会自动更新。
    3. idtoken：(不建议更改) 认证的 IDToken ，一般不需要手动配置，认证完成后会自动更新。
    4. issuerurl：认证的 OIDC 服务器地址，也可通过 --issuer-url 参数配置。
    5. refreshtoken：(不建议更改) 认证的 RefreshToken，一般不需要手动配置，认证完成后会自动更新。
    6. clientid: (不建议更改) 用于 OIDC Server 识别 CLI 身份，默认为 bff-client（可以通过命令 kubectl get configmap -n u4a-system oidc-server -o jsonpath='{.data.config\.yaml}' | yq '.staticClients[] | select(.name == "bff-client") | .id' 获取当前集群的配置，这条命令需要需要安装 yq 工具）
    7. clientsecret: (不建议更改) 用于 OIDC Server 识别 CLI 身份，默认为 61324af0-1234-4f61-b110-ef57013267d6（可以通过命令 kubectl get configmap -n u4a-system oidc-server -o jsonpath='{.data.config\.yaml}' | yq '.staticClients[] | select(.name == "bff-client") | .secret' 获取当前集群的配置，这条命令需要安装 yq 工具）
  • cluster 为 kubernetes 集群相关配置：
    1. server：kube-oidc-proxy 的地址。（可以通过命令 kubectl get po -n u4a-system -l app=kube-oidc-proxy 获取当前集群 oidc-proxy 的 pod 配置，这里需要这个 pod 的对外 IP 和 --secure-port 的端口，默认端口为 9443 ）
  • saas 为 saas 组件相关配置：
    1. depository 为存证相关配置
      1. server 为存证服务器配置
提示

auth认证信息获取步骤如下:

  1. 设置配置文件中 auth.enable 的值为 true 或者使用 --enable-auth 参数可以开启 OIDC 认证模式
  2. 通过配置配置文件中 auth.issuerurl 的值或者使用 --issuer-url 参数来指定认证 OIDC 服务器的地址；通过配置配置文件中 auth.clientid 的值或者使用 --client-id 参数来指定认证 OIDC 的 ClientID 的值；通过配置配置文件中 auth.clientsecret 的值或者使用 --client-secret 参数来指定认证 OIDC 的 ClientSecret 的值
  3. 运行任何有效的 CLI 命令,触发获取认证信息处理。

处理流程如下:

  1. 读取配置文件中的认证信息，验证认证信息是否有效。如果认证过期，将会首先尝试后台自动刷新IDToken认证信息
  2. 如果后台刷新失效时将自动跳转到OIDC认证页面，认证成功后，自动更新配置文件，填充auth信息。如下图所示:

认证展示

账户管理​

添加账户​

通过 -h 查看命令定义，目前不支持自定义私钥，由代码自动生成。 --wallet 用来指定生成的用户账户地址以及私钥存储位置，默认是 $HOME/.bestchains/wallet。目前数据未做加密处理。

➜  bc-cli git:(main) ✗ ./bc-cli create account -h
Create an account

Usage:
  bc-cli create account [flags]

Flags:
  -h, --help            help for account
      --wallet string   wallet path (default "$HOME/.bestchains/wallet")

示例1. 自动生成私钥，将用户信息存储到默认位置

➜  bc-cli git:(main) ✗ ./bc-cli create account
account/0xc3c45ce32438c2d7fb54cee74ff27505bf0bafc8 created
➜  bc-cli git:(main) ✗ ls $HOME/.bestchains/wallet
0xc3c45ce32438c2d7fb54cee74ff27505bf0bafc8

示例2. 自动生成私钥，并且将账户信息存储到本地的/tmp/abc目录

➜  bc-cli git:(main) ✗ ./bc-cli create account --wallet=/tmp/abc
account/0xd133443860676fdf41f9d51a422642866ec4c61d created
➜  bc-cli git:(main) ✗ ./bc-cli get account --wallet=/tmp/abc
ACCOUNT
0xd133443860676fdf41f9d51a422642866ec4c61d

查看账户信息​

通过 -h 查看命令定义，通过 --wallet 参数来查看不同 wallet 下的账户列表。

➜  bc-cli git:(main) ✗ ./bc-cli get account -h
Display account information according to wallet path

Usage:
  bc-cli get account [flags]

Flags:
  -h, --help            help for account
      --wallet string   wallet path (default "$HOME/.bestchains/wallet")
➜  bc-cli git:(main) ✗ ./bc-cli get account
ACCOUNT
0x7f0c733bcdb6721ed266a952ec697d9bea8022ad
0xc3c45ce32438c2d7fb54cee74ff27505bf0bafc8
➜  bc-cli git:(main) ✗ ./bc-cli get account --wallet=/tmp/abc
ACCOUNT
0xafbff1c5658a03aa03a08f9e3ab8cab2d9a5a1eb

删除账户信息​

通过 -h 查看命令定义，通过 --wallet 参数来删除不同 wallet 下的账户列表, 支持一次删除多个。

➜  bc-cli git:(main) ✗ ./bc-cli delete account -h
Delete the account according to the wallet information.

Usage:
  bc-cli delete account [address] [flags]

Flags:
  -h, --help            help for account
      --wallet string   wallet path (default "$HOME/.bestchains/wallet")

示例1. 删除 /tmp/abc 下面的账户信息

➜  bc-cli git:(main) ✗ ./bc-cli delete account --wallet=/tmp/abc 0xafbff1c5658a03aa03a08f9e3ab8cab2d9a5a1eb
account "0xafbff1c5658a03aa03a08f9e3ab8cab2d9a5a1eb" deleted
➜  bc-cli git:(main) ✗ ./bc-cli get account --wallet=/tmp/abc
ACCOUNT

示例2. 删除默认位置的多个账户信息

可以注意到，在删除的命令后面多一个abc账户，但是这账户信息并不存在。所以给出报错信息。

➜  bc-cli git:(main) ✗ ./bc-cli get account
ACCOUNT
0x7f0c733bcdb6721ed266a952ec697d9bea8022ad
0xc3c45ce32438c2d7fb54cee74ff27505bf0bafc8
➜  bc-cli git:(main) ✗ ./bc-cli delete account 0x7f0c733bcdb6721ed266a952ec697d9bea8022ad 0xc3c45ce32438c2d7fb54cee74ff27505bf0bafc8 abc
account "0x7f0c733bcdb6721ed266a952ec697d9bea8022ad" deleted
account "0xc3c45ce32438c2d7fb54cee74ff27505bf0bafc8" deleted
Error: account "abc" remove /home/digua/.bestchains/wallet/abc: no such file or directory

存证管理​

创建存证​

通过 -h 查看命令定义

Usage:
  bc-cli create depository NAME [args] [flags]

Flags:
  -a, --account string       account to be used
      --contentID string     depot file ID
  -t, --contentType string   depot file type
  -h, --help                 help for depository
  -o, --host string          host URL
  -n, --name string          depot name
  -p, --platform string      depot source platform
      --untrusted            put untrusted value (default true)
  -w, --wallet string        wallet path

示例1. 创建未受信任存证（无需账号信息），返回存证 id： name：存证名称；contentID：存证文件ID；type：存证文件类型；platform：存证来源平台

./bc-cli create depository -n dep1 --contentID 123456789 -t file -p bestchains --host https://bc-saas.172.22.96.209.nip.io
{"kid":"2afbb84dc8d19cd8c10264a8b72e7975385d169b"}

示例2. 创建存证（需要账号信息），返回存证 id： name：存证名称；contentID：存证文件ID；type：存证文件类型；platform：存证来源平台；untrusted：是否存储未受信任存证（此处为否）；account：账号区块链地址，格式为0x0000000000000000000000000000000000000000

./bc-cli create depository -n dep1 --contentID 1234567890 -t file -p bestchains --host https://bc-saas.172.22.96.209.nip.io --untrusted=false -a 0x6b72ee599c570831ceb41809cb49805eb58e6f59
{"kid":"2636d287351f1f51f35e98602c055ede1fdeb966"}

存证列表​

通过 -h 查看命令定义

➜  bc-cli git:(main) ✗ ./bc-cli get depository -h
Get one or more depositories

Usage:
  bc-cli get depository [KID] [flags]

Flags:
  -c, --contentName string   search depository by content name
  -f, --from int             pagination
  -h, --help                 help for depository
      --host string          bc-saas server
  -k, --kid string           search depository by kid
  -n, --name string          search depository by name
  -s, --size int             pagination size (default 10)

示例1. 获取全部存证信息

➜  bc-cli git:(main) ✗ ./bc-cli get depository --host=https://bc-saas.172.22.96.209.nip.io
INDEX    KID                                         PLATFORM      OPERATOR                                      OWNER                                         BLOCKNUMBER    TIME
7        fbef356cae5b9ada2b0e9c5bc6138fdf320ed1ba    bestchains    0x02624bfc011381aa1f4e19db60e3f46673f1f171                                                  73             2023-05-06T13:24:53
6        18b682430b2ee5cdcb17c0ea678a52223056d256    bestchains    0x02624bfc011381aa1f4e19db60e3f46673f1f171    0xe4af6dcf67b5ec06d903ec175a0c7e47f38249b2    72             2023-05-06T11:28:12
28       d2a61f5d32cb5c8e73e7b36b4011b63c9bc5af68    bestchains                                                                                                55             2023-04-27T10:34:33
27       1da7b7b3ae76706bf16b7a094593650c93696b0f    bestchains                                                                                                54             2023-04-27T09:38:09
5        93b81217a6c96da33729f54eadc57a7e3ae848e0    bestchains    0x02624bfc011381aa1f4e19db60e3f46673f1f171                                                  53             2023-04-26T19:07:40
4        ac5eb9848caa1c8002b019493294f86c74e63bba    bestchains    0x02624bfc011381aa1f4e19db60e3f46673f1f171                                                  52             2023-04-26T19:00:30
3        60d7b8f15a48617fd9879815293db9cab1d5bdc6    bestchains    0x02624bfc011381aa1f4e19db60e3f46673f1f171                                                  51             2023-04-26T18:52:17
2        e29afb7686ba0fa465295624f43b97df5505b665    bestchains    0x02624bfc011381aa1f4e19db60e3f46673f1f171                                                  50             2023-04-26T18:51:15
1        a86d95ee04f272aa9bcb619196a6a59efd97a6b1    bestchains    0x02624bfc011381aa1f4e19db60e3f46673f1f171                                                  49             2023-04-26T18:51:12
0        18d714ab63365b4c198479a6607ad652fd0c9d56    bestchains    0x02624bfc011381aa1f4e19db60e3f46673f1f171                                                  48             2023-04-26T18:51:09

示例2. 根据 kid 获取存证

➜  bc-cli git:(main) ✗ ./bc-cli get depository --host=https://bc-saas.172.22.96.209.nip.io -k=fbef356cae5b9ada2b0e9c5bc6138fdf320ed1ba
INDEX    KID                                         PLATFORM      OPERATOR                                      OWNER    BLOCKNUMBER    TIME
7        fbef356cae5b9ada2b0e9c5bc6138fdf320ed1ba    bestchains    0x02624bfc011381aa1f4e19db60e3f46673f1f171             73             2023-05-06T13:24:53

示例3. 使用 from, size 控制返回数量以及偏移数据

➜  bc-cli git:(main) ✗ ./bc-cli get depository --host=https://bc-saas.172.22.96.209.nip.io -f=1 -s=3
INDEX    KID                                         PLATFORM      OPERATOR                                      OWNER                                         BLOCKNUMBER    TIME
6        18b682430b2ee5cdcb17c0ea678a52223056d256    bestchains    0x02624bfc011381aa1f4e19db60e3f46673f1f171    0xe4af6dcf67b5ec06d903ec175a0c7e47f38249b2    72             2023-05-06T11:28:12
28       d2a61f5d32cb5c8e73e7b36b4011b63c9bc5af68    bestchains                                                                                                55             2023-04-27T10:34:33
27       1da7b7b3ae76706bf16b7a094593650c93696b0f    bestchains                                                                                                54             2023-04-27T09:38:09

下载证书​

通过 -h 查看命令定义，通过 --certificate 参数来表示需要下载证书，--certificateStyle 参数来指定证书的语言，可选值为 CN 或 ENG，默认为 CN。

➜  bc-cli git:(main) ✗ ./bc-cli get depository -h
Get one or more depositories

Usage:
  bc-cli get depository [KID] [flags]

Flags:
      --certificate               download certificate by kid
      --certificateStyle string   language of certificate（optional values are CN or ENG） (default "CN")
  -c, --contentName string        search depository by content name
  -f, --from int                  pagination
  -h, --help                      help for depository
      --host string               bc-saas server (default "http://localhost:9999")
  -k, --kid string                search depository by kid
  -n, --name string               search depository by name
  -s, --size int                  pagination size (default 10)

示例1. 下载一个证书，证书为英文

➜  bc-cli git:(main) ✗ ./bc-cli get depository cd97ee2faf890a3b3a5527ee9571a735aa3e4b0c --certificate --certificateStyle ENG
certificate cd97ee2faf890a3b3a5527ee9571a735aa3e4b0c.pdf downloaded

示例2. 下载多个证书，证书为中文

➜  bc-cli git:(main) ✗ ./bc-cli get depository cd97ee2faf890a3b3a5527ee9571a735aa3e4b0c 5635ab1159528b88a099cccf81a3f2f0bb6f438f --certificate
certificate cd97ee2faf890a3b3a5527ee9571a735aa3e4b0c.pdf downloaded
certificate 5635ab1159528b88a099cccf81a3f2f0bb6f438f.pdf downloaded

Bestchains 资源管理​

获取组织列表​

获取组织列表，支持获取一个，多个，以及全部的用户可见的组织。如果没有权限，会返回错误信息。
支持 kubectl get 的展示性参数，例如 -oyaml, -ojson, --showlabels 等，以及通过 labelselector 和 fieldselector 选择资源。

示例1. 获取全部组织信息

➜  bc-cli git:(org) ✗ ./bc-cli get org
NAME        AGE
2345        20d
dayu        24d
tenxcloud   24d
testorg1    24d
testorg2    24d

示例2. 获取一个，多个组织信息

➜  bc-cli git:(org) ✗ ./bc-cli get org dayu
NAME   AGE
dayu   24d
➜  bc-cli git:(org) ✗ ./bc-cli get org dayu testorg2
NAME       AGE
dayu       24d
testorg2   24d

示例3. 通过标签选择组织

➜  bc-cli git:(org) ✗ ./bc-cli get org -l=bestchains.organization.admin=marsdawe --show-labels
NAME       AGE   LABELS
testorg1   24d   bestchains.organization.admin=marsdawe
testorg2   24d   bestchains.organization.admin=marsdawe

示例4. 以 yaml 方式展示内容

➜  bc-cli git:(org) ✗ ./bc-cli get org -l=bestchains.organization.admin=marsdawe -oyaml
apiVersion: v1
items:
- apiVersion: ibp.com/v1beta1
  kind: Organization
  metadata:
    creationTimestamp: "2023-04-17T09:04:39Z"
    generation: 1
    labels:
      bestchains.organization.admin: marsdawe
    name: testorg1
    resourceVersion: "574846745"
    uid: 68877e3a-0411-40fb-a0cf-11a6fe9fcf8c
  # ...
- apiVersion: ibp.com/v1beta1
  kind: Organization
  metadata:
    creationTimestamp: "2023-04-17T09:26:25Z"
    generation: 1
    labels:
      bestchains.organization.admin: marsdawe
    name: testorg2
    resourceVersion: "568602322"
    uid: 4740807c-9575-478d-8578-f8fe394dd704
  # ...
kind: List
metadata: {}

获取提议列表​

获取当前用户的提议，支持获取一个、多个，以及当前用户的全部提议。通过 -h 查看命令定义。 支持 kubectl get 的展示性参数，例如 -o json, -o yaml 等。

示例1. 获取当前用户的全部提议

➜  bc-cli git:(main) ✗ ./bc-cli get proposal
NAME                               AGE
create-federation-proposal-9naqk   41d
create-federation-proposal-cem6r   44d
create-federation-proposal-eail0   44d
deploy-chaincode-proposal-1wtno    8d

示例2. 获取一个、多个提议信息

➜  bc-cli git:(main) ✗ ./bc-cli get proposal create-federation-proposal-9naqk
NAME                               AGE
create-federation-proposal-9naqk   41d

➜  bc-cli git:(main) ✗ ./bc-cli get proposal create-federation-proposal-9naqk create-federation-proposal-cem6r
NAME                               AGE
create-federation-proposal-9naqk   41d
create-federation-proposal-cem6r   44d

示例3. 以 yaml 方式展示提议信息

➜  bc-cli git:(main) ✗ ./bc-cli get proposal deploy-chaincode-proposal-1wtno -o yaml
apiVersion: ibp.com/v1beta1
kind: Proposal
metadata:
  creationTimestamp: "2023-05-23T06:05:03Z"
  generation: 1
  labels:
    bestchains.chaincode.delete.proposal: chaincode-du5kk
    bestchains.proposal.type: DeployChaincodeProposal
  name: deploy-chaincode-proposal-1wtno
  ownerReferences:
  - apiVersion: ibp.com/v1beta1
    kind: Federation
    name: proof
    uid: 82633066-8b3b-4f7e-ad5a-7f77257808a9
spec:
  deployChaincode:
    chaincode: chaincode-du5kk
    externalBuilder: chaincodebuild-k0067
    members:
    - initiator: true
      name: tenxcloud
  # ...

获取网络列表​

获取当前用户的网络列表，支持获取一个、多个，以及当前用户的全部网络。通过 -h 查看命令定义。 支持 kubectl get 的展示性参数，例如 -o json、-o yaml 等。

示例1. 获取当前用户的全部网络

➜  bc-cli git:(main) ✗ ./bc-cli get network
NAME          AGE
proof-c0zpw   44d
test-727th    44d

示例2. 获取一个或多个网络信息

➜  bc-cli git:(main) ✗ ./bc-cli get network proof-c0zpw
NAME          AGE
proof-c0zpw   44d
➜  bc-cli git:(main) ✗ ./bc-cli get network proof-c0zpw test-727th
NAME          AGE
proof-c0zpw   44d
test-727th    44d

示例3. 以 yaml 的方式展示网络信息

➜  bc-cli git:(main) ✗ ./bc-cli get network proof-c0zpw -o yaml
apiVersion: ibp.com/v1beta1
kind: Network
metadata:
  creationTimestamp: "2023-04-17T09:09:45Z"
  generation: 1
  labels:
    bestchains.network.federation: proof
    bestchains.network.initiator: tenxcloud
  name: proof-c0zpw
spec:
  federation: proof
  # ...

获取通道连接文件​

获取通道的连接文件，通过 -h 查看命令定义，--channel 用来指定通道名称，--org 用来指定通道相关的组织（需是用户作为 admin 管理的组织），--peer 用来指定通道相关的节点，--output 用来指定文件输出的格式，支持“json”和“yaml”，--dir 用来指定文件输出的目录，默认是 $HOME/.bestchains/connProfile。

➜  bc-cli git:(main) ✗ ./bc-cli get connProfile -h
Get channel's connection profile

Usage:
  bc-cli get connProfile [flags]

Flags:
      --channel string   channel name
      --dir string       output file path
  -h, --help             help for connProfile
      --org string       organization name
      --output string    output file type (default "json")
      --peer string      fabric peer name

示例1. 查看通道资源名称和节点名称

➜  ~ kubectl get chan channel-1gsuf -o yaml
apiVersion: ibp.com/v1beta1
kind: Channel
metadata:
  generation: 1
  labels:
    bestchains.channel.network: dayu-7e064
  name: channel-1gsuf # 通道资源名称
spec:
  id: dayu
  license:
    accept: true
  members:
  - initiator: true
    joinedAt: "2023-04-17T09:27:37Z"
    name: dayu # 相关组织
  network: dayu-7e064
  peers:
  - name: dayu-peer-fb87u # 相关节点
    namespace: dayu

示例2. 获取一个通道的连接文件

➜  bc-cli git:(main) ✗ ./bc-cli get connProfile --channel channel-5b2dq --org dayu --peer dayu-peer-fb87u --output json --enable-auth
connProfile /Users/xxx/.bestchains/connProfile/channel-5b2dq.json saved

获取 EndorsePolicy​

获取指定网络下 EndorsePolicy 列表，支持获取一个、多个。通过 -h 查看命令定义。--network 是必选参数，指定具体的网络。--channel 是可选参数，指定网络下若干通道，多个通道名称通过逗号分隔。
支持 kubectl get 的展示性参数，例如 -o json、-o yaml 等。

➜  bc-cli git:(main) ✗ ./bc-cli get ep -h
Get endorsepolicy according to blockchain network

Examples:
  # Get all the endorsepolicies under a network
  bc-cli get ep --netowrk=<network-name>

  # Get the endorsepolicy for a number of channels specified by a network
  bc-cli get ep --network=<network-name> --channel=<channel1>,<channel2>

  # Specify the endorsepolicy name
  bc-cli get ep --network=<netowkr-name> ep1 ep2

Usage:
  bc-cli get ep [NAME] [flags]

示例1. 获取某个网络的全部 EndorsePolicy

➜  bc-cli git:(main) ✗ ./bc-cli get ep --network=proof-c0zpw -o=custom-columns=NAEM:.metadata.name,CHANNEL:.spec.channel
NAEM            CHANNEL
epolicy-7bu8o   channel-kll7r
epolicy-bj4xw   channel-z56ar
epolicy-tkeyx   channel-c9j2j
epolicy-toy3i   channel-d2jty

示例2. 获取某个网络下指定通道的全部 EndorsePolicy

➜  bc-cli git:(main) ✗ ./bc-cli get ep --network=proof-c0zpw --channel=channel-kll7r,channel-d2jty -o=custom-columns=NAEM:.metadata.name,CHANNEL:.spec.channel
NAEM            CHANNEL
epolicy-7bu8o   channel-kll7r
epolicy-toy3i   channel-d2jty

示例3. 获取某个网络指定通道下面的若干 EndorsePolicy

尝试获取名字为 abc, epolicy-7bu8o 的 EndorsePolicy，但是 abc 在集群中并不存在， 所以最后只展示 epolicy-7bu8o.

➜  bc-cli git:(main) ✗ ./bc-cli get ep --network=proof-c0zpw --channel=channel-kll7r,channel-d2jty -o=custom-columns=NAEM:.metadata.name,CHANNEL:.spec.channel epolicy-7bu8o abc
NAEM            CHANNEL
epolicy-7bu8o   channel-kll7r

获取 chaincodebuild​

获取指定网络下或者指定若干名称的 chaincodebuild 列表，支持获取一个，多个，通过 -h 查看命令定义。
如果指定了若干chaincodebuild 的名称，--network 是非必选参数。否则 --network 是必选参数，指定具体的网络。
--id 是可选参数，chaincodebuild 的 id。
--version 也是可选参数，chaincodebuild 的版本。

支持 kubectl get 的展示性参数，例如 -o json、-o yaml 等。

➜  bc-cli git:(main) ✗ ./bc-cli get ccb -h                   
Get the list of chaincodebuild created under a network

Usage:
  bc-cli get ccb [NAME] [flags]

示例1. 获取某个网络下的所有 chaincodebuild

➜  bc-cli git:(main) ✗ ./bc-cli get ccb --network=proof-c0zpw
NAME                   AGE
chaincodebuild-0af6b   67d
chaincodebuild-3n4nr   66d
chaincodebuild-3z6so   60d
chaincodebuild-78wh0   66d
chaincodebuild-cijkd   25d
chaincodebuild-fd76h   67d
chaincodebuild-jc1hr   66d
chaincodebuild-k0067   31d
chaincodebuild-m1m8z   58d
chaincodebuild-ofo8j   62d
chaincodebuild-psbot   66d
chaincodebuild-syltf   65d
chaincodebuild-u802r   63d
chaincodebuild-u9e8k   65d

示例2. 获取某个网络下的指定 id 的 chaincodebuild 列表

➜  bc-cli git:(main) ✗ ./bc-cli get ccb --network=proof-c0zpw --id=proof
NAME                   AGE
chaincodebuild-0af6b   67d
chaincodebuild-78wh0   66d
chaincodebuild-fd76h   67d
chaincodebuild-ofo8j   62d
chaincodebuild-syltf   65d
chaincodebuild-u802r   63d
chaincodebuild-u9e8k   65d

示例3. 获取某个网络下指定 id 和 version 的 chaincodebuild 列表

➜  bc-cli git:(main) ✗ ./bc-cli get ccb --network=proof-c0zpw --id=proof --version=v0.0.1
NAME                   AGE
chaincodebuild-0af6b   67d
chaincodebuild-fd76h   67d

示例4. 获取指定若干名称的 chaincodebuild

➜  bc-cli git:(main) ✗ ./bc-cli get ccb chaincodebuild-0af6b chaincodebuild-fd76h   
NAME                   AGE
chaincodebuild-0af6b   67d
chaincodebuild-fd76h   67d

获取 channel​

获取指定网络下或指定名称的 channel，按名称获取支持一个、多个，通过 -h 查看命令定义。--network 为必选参数。

$ ./bc-cli get channel -h                   
Get the list of channels created under a network

Usage:
  bc-cli get channel [NAME] -n NETWORK-NAME [flags]

示例1. 获取指定网络下的所有 channel

$ ./bc-cli get channel -n proof-c0zpw
NAME            AGE
channel-z56ar   70d
channel-c9j2j   69d
channel-d2jty   66d
channel-kll7r   35d

示例2. 获取指定网络中某一名称的 channel

$ ./bc-cli get channel channel-z56ar -n proof-c0zpw
NAME            AGE
channel-z56ar   70d

示例3. 获取指定网络中若干名称的 channel

$ ./bc-cli get channel channel-z56ar channel-c9j2j -n proof-c0zpw
NAME            AGE
channel-z56ar   70d
channel-c9j2j   69d

获取 chaincode​

获取指定 channel 的 chaincode 列表，支持查看一个或多个 chaincode 详细信息。通过 -h 查看命令定义。 --channel 是必选参数，除非指定了若干 chaincode 名称。 --id 是可选参数，chaincode 的 id。 --version 是可选参数，chaincode 的 version。

支持 kubectl get 的展示性参数，例如 -o json、-o yaml 等。

➜  bc-cli git:(main) ✗ ./bc-cli get chaincode -h
Get a list of the chaincode installed on a channel

Usage:
  bc-cli get chaincode [NAME] [flags]

示例1. 获取指定 channel 下的 chaincode 列表

➜  bc-cli git:(main) ✗ ./bc-cli get chaincode --channel channel-z56ar
NAME              AGE
chaincode-3bdbf   69d
chaincode-79t9d   70d
chaincode-9x3y4   69d
chaincode-d632u   69d
chaincode-g6vhr   69d
chaincode-l10c3   69d
chaincode-r1iu2   61d

示例2. 获取指定 channel 下的某个 id 的 chaincode 列表

➜  bc-cli git:(main) ✗ ./bc-cli get chaincode --channel channel-z56ar --id acl
NAME              AGE
chaincode-d632u   69d
chaincode-g6vhr   69d
chaincode-l10c3   69d

示例3. 获取指定 channel 下的某个 id 和 version 的 chaincode 列表

➜  bc-cli git:(main) ✗ ./bc-cli get chaincode --channel channel-z56ar --id acl --version v0.0.1
NAME              AGE
chaincode-d632u   69d
chaincode-g6vhr   69d
chaincode-l10c3   69d

示例4. 获取指定若干名称的 chaincode

➜  bc-cli git:(main) ✗ ./bc-cli get chaincode chaincode-r1iu2 chaincode-l10c3
NAME              AGE
chaincode-r1iu2   61d
chaincode-l10c3   69d

示例5. 以 yaml 方式展示 chaincode 详细信息

➜  bc-cli git:(main) ✗ ./bc-cli get chaincode chaincode-r1iu2 -o yaml
apiVersion: ibp.com/v1beta1
kind: Chaincode
metadata:
  creationTimestamp: "2023-04-26T08:38:11Z"
  generation: 2
  labels:
    bestchains.chaincode.channel: channel-z56ar
    bestchains.chaincode.id: depository
    bestchains.chaincode.version: v0.0.2
    bestchians.chaincode.endorsementpolicy: epolicy-bj4xw
  name: chaincode-r1iu2
  resourceVersion: "673796295"
  uid: 3fb44b49-274f-4d39-9df4-20a204ac7aef
spec:
  channel: channel-z56ar
  endorsePolicyRef:
    name: epolicy-bj4xw
  externalBuilder: chaincodebuild-m1m8z
  id: depository
  # ...