Choerodon CLI工具

Choerodon CLI工具主要面向开发人员，支持使用命令行的方式来执行平台中的页面操作。在使用Choerodon的CLI工具前，需要做以下准备。

准备操作

1. 下载CLI工具

• 首先需要下载CLI安装包，下载地址如下：https://file.choerodon.com.cn/choerodon-install/c7nctl
• 下载至本地后，将其解压至可执行文件bin目录下即可。

2. 创建client

由于CLI工具在访问Choerodon平台的时候需要授权，因此需要采用password类型的oauth2方式去获取token；换言之，用户需要在Choerodon平台的组织层-组织设置-客户端中创建客户端，具体设置如下图：

工具操作

Choerodon CLI工具目前支持以下操作，后续的版本将会涵盖平台中更多的功能。

1. 登陆

c7nctl login -U xxx -P xxx –url xxxx (-U 用户名 -P 密码 –url 平台gateway地址)

登陆成功后，系统会在用户的根目录创建一个.c7n.yaml文件，该文件包含了当前用户的信息，用于后续操作的授权（在没有登陆的情况下去操作命令，会提示此操作需要登陆）。文件内容为：

OrganizationCode: c7nctl-org OrganizationId: 142 ProjectCode: c7nctl-pro ProjectId: 406 Server: http://api.alpha.saas.hand-china.com Token: bfb6da92-e8ca-4e97-8080-a4c58e7c19b6

2. 登出

c7nctl logout

登出之后，会清空.c7n.yaml文件，登出之后再进行命令操作会提示此操作需要登陆。

3. 查询组织

c7nctl get org

此操作用于查询此用户在平台中有权限的组织，结果如下:

4. 修改默认组织

c7nctl use org -o xxx

此操作用于修改上下文中用户默认的组织，已设置的默认组织会用于后续的命令之中。

5. 查询项目

c7nctl get pro

此操作用于查询此用户在默认组织或指定组织中有权限的项目，结果如下:

6. 修改默认项目

c7nctl use pro -p xxx

此操作用于修改上下文中用户默认的项目，已设置的默认项目会用于后续的命令之中。

7. 查询组织层的应用模板

c7nctl get appTemplate -o xxx(-o 非必输,传了用指定组织，不传用默认组织)

此操作用于查询组织层的应用模板，且只能在此用户有权限的组织中查询。

8. 创建组织层的模板

c7nctl create appTemplate –name xxx –code xxx –desciption xxx –copyFrom xxx(–copyFrom 非必输,可选择已有的模板code创建，不填创建空模板库)

9. 查询组织层集群

c7nctl get cluster -o xxx(-o 非必输)

10. 创建组织层集群

c7nctl create cluster –name xxx –code xxx –description xxx -o xxx(-o 非必输)

11. 查询项目应用

c7nctl get app -p xxx(-p 非必输)

12. 创建项目应用

c7nctl create app –name xxx –code xxx –type xxx –appTemplate xxx -p xxx(-p 非必输)

13. 查询应用版本

c7nctl get appVersion -a xxx -p xxx(-p 非必输)

14. 查询环境列表

c7nctl get allEnv -p xxx(-p 非必输)

15. 创建环境

c7nctl create env –name xxx –code xxx –cluster xxx -p xxx(-p 非必输)

16. 查询实例列表

c7nctl get instance –env xxx -p xxx(-p 非必输)

17. 创建实例

c7nctl create instance –env xxx –content xxx -p xxx(-p 非必输)

18. 创建网络

c7nctl create service –env xxx –content xxx -p xxx(-p 非必输)

19. 创建域名

c7nctl create ingress –env xxx –content xxx -p xxx(-p 非必输)

20. 创建证书

c7nctl create cert –env xxx –content xxx -p xxx(-p 非必输)

21. 创建配置映射

c7nctl create configMap –env xxx –content xxx -p xxx(-p 非必输)

22. 创建密文

c7nctl create secret –env xxx –content xxx -p xxx(-p 非必输)