cli addon status (#767)

* addon status

Signed-off-by: 楚岳 <wangyike.wyk@alibaba-inc.com>

* fix comments

Signed-off-by: 楚岳 <wangyike.wyk@alibaba-inc.com>

* fix comments

Signed-off-by: 楚岳 <wangyike.wyk@alibaba-inc.com>
This commit is contained in:
wyike 2022-06-22 15:13:26 +08:00 committed by GitHub
parent 2e3a06dc4b
commit 426c9dcb32
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 184 additions and 4 deletions

View File

@ -63,13 +63,13 @@ Addon: fluxcd enabled Successfully.
You can also install addons with some advanced flags.
* Choose one specific version by adding `--version` flag in this command. eg:
* Choose one specific version by adding `--version` flag in this command. e.g:
```shell
vela addon enable fluxcd --version=1.0.0
```
* Choose specific clusters for installation. You can use `--cluster` flag to choose specific clusters. eg:
* Choose specific clusters for installation. You can use `--cluster` flag to choose specific clusters. e.g:
```shell
vela addon enable <addon-name> --clusters={cluster1,cluster2}
@ -77,6 +77,51 @@ vela addon enable <addon-name> --clusters={cluster1,cluster2}
By default, the place for installation is specified as control plane cluster or managed cluster inside the metadata of addon.
* Some addons support setting parts of parameter while enabling. For example `velaux` addon supports change image repository by setting `repo` parameter, then you can change the repo address to your own. e.g:
```shell
vela addon enable velaux repo=<your repo address>
```
### Get addon info
If you want to check the detail status of an addon, or get more available parameters and other useful info of an addon, you can use command `addon status`. For example:
```shell
$ vela addon enable velaux --verbose
velaux: disabled
KubeVela User Experience (UX). An extensible, application-oriented delivery and management Dashboard.
==> Registry Name
KubeVela
==> Available Versions
[v1.4.3, v1.4.2, v1.4.0, v1.4.0-beta.2, v1.3.6, v1.3.4, v1.3.3, v1.3.2, ...]
==> Dependencies ✔
[]
==> Parameters
-> dbType: Specify the database type, current support KubeAPI(default) and MongoDB.
default: "kubeapi"
required: ✔
-> dbURL: Specify the MongoDB URL. it only enabled where DB type is MongoDB.
-> gatewayDriver: Specify the gateway type.
default: "nginx"
required: ✔
-> imagePullSecrets: Specify the names of imagePullSecret for private image registry, eg. "{a,b,c}"
-> serviceType: Specify the service type.
default: "ClusterIP"
required: ✔
-> database: Specify the database name, for the kubeapi db type, it represents namespace.
-> dex: Specify whether to enable the dex
default: "false"
required: ✔
-> domain: Specify the domain, if set, ingress will be created if the gateway driver is nginx.
-> repo: Specify the image hub of velaux, eg. "acr.kubevela.net"
-> serviceAccountName: Specify the serviceAccountName for apiserver
default: "kubevela-vela-core"
required: ✔
```
As above shows, these infos contain the available parameters, available versions, dependent addons and description of and addon.
### Discover the capabilities installed
Once addon installed, end user can discover and use these capabilities immediately.

View File

@ -73,6 +73,51 @@ vela addon enable fluxcd --version=1.0.0
vela addon enable <addon-name> --clusters={cluster1,cluster2}
```
某些插件支持在启用时设置一些参数。例如 `velaux` 插件支持通过设置 `repo` 参数使用其他的镜像仓库。你就可以通过以下命令设置使用你自己的镜像仓库:
```shell
vela addon enable velaux repo=<your repo address>
```
### 获取插件详情
如果你想获取插件的详细信息,或者查看插件支持哪些启用参数等其他信息,你就可以用 `addon status` 的命令。 例如:
```shell
$ vela addon enable velaux --verbose
velaux: disabled
KubeVela User Experience (UX). An extensible, application-oriented delivery and management Dashboard.
==> Registry Name
KubeVela
==> Available Versions
[v1.4.3, v1.4.2, v1.4.0, v1.4.0-beta.2, v1.3.6, v1.3.4, v1.3.3, v1.3.2, ...]
==> Dependencies ✔
[]
==> Parameters
-> dbType: Specify the database type, current support KubeAPI(default) and MongoDB.
default: "kubeapi"
required: ✔
-> dbURL: Specify the MongoDB URL. it only enabled where DB type is MongoDB.
-> gatewayDriver: Specify the gateway type.
default: "nginx"
required: ✔
-> imagePullSecrets: Specify the names of imagePullSecret for private image registry, eg. "{a,b,c}"
-> serviceType: Specify the service type.
default: "ClusterIP"
required: ✔
-> database: Specify the database name, for the kubeapi db type, it represents namespace.
-> dex: Specify whether to enable the dex
default: "false"
required: ✔
-> domain: Specify the domain, if set, ingress will be created if the gateway driver is nginx.
-> repo: Specify the image hub of velaux, eg. "acr.kubevela.net"
-> serviceAccountName: Specify the serviceAccountName for apiserver
default: "kubevela-vela-core"
required: ✔
```
如上所示, 命令结果包含了一个插件的参数详细信息,可用版本,依赖的其他的插件等信息。
安装完成后,插件中的功能会以组件,运维特征,工作流步骤等形式呈现,你可以通过 `vela component``vela trait` 等命令查看新增的能力,也可以在[插件的参考文档](../../reference/addons/overview)中查看每个官方插件对应的能力.
### 删除/卸载已安装的插件

View File

@ -73,6 +73,51 @@ vela addon enable fluxcd --version=1.0.0
vela addon enable <addon-name> --clusters={cluster1,cluster2}
```
某些插件支持在启用时设置一些参数。例如 `velaux` 插件支持通过设置 `repo` 参数使用其他的镜像仓库。你就可以通过以下命令设置使用你自己的镜像仓库:
```shell
vela addon enable velaux repo=<your repo address>
```
### 获取插件详情
如果你想获取插件的详细信息,或者查看插件支持哪些启用参数等其他信息,你就可以用 `addon status` 的命令。 例如:
```shell
$ vela addon enable velaux --verbose
velaux: disabled
KubeVela User Experience (UX). An extensible, application-oriented delivery and management Dashboard.
==> Registry Name
KubeVela
==> Available Versions
[v1.4.3, v1.4.2, v1.4.0, v1.4.0-beta.2, v1.3.6, v1.3.4, v1.3.3, v1.3.2, ...]
==> Dependencies ✔
[]
==> Parameters
-> dbType: Specify the database type, current support KubeAPI(default) and MongoDB.
default: "kubeapi"
required: ✔
-> dbURL: Specify the MongoDB URL. it only enabled where DB type is MongoDB.
-> gatewayDriver: Specify the gateway type.
default: "nginx"
required: ✔
-> imagePullSecrets: Specify the names of imagePullSecret for private image registry, eg. "{a,b,c}"
-> serviceType: Specify the service type.
default: "ClusterIP"
required: ✔
-> database: Specify the database name, for the kubeapi db type, it represents namespace.
-> dex: Specify whether to enable the dex
default: "false"
required: ✔
-> domain: Specify the domain, if set, ingress will be created if the gateway driver is nginx.
-> repo: Specify the image hub of velaux, eg. "acr.kubevela.net"
-> serviceAccountName: Specify the serviceAccountName for apiserver
default: "kubevela-vela-core"
required: ✔
```
如上所示, 命令结果包含了一个插件的参数详细信息,可用版本,依赖的其他的插件等信息。
安装完成后,插件中的功能会以组件,运维特征,工作流步骤等形式呈现,你可以通过 `vela component``vela trait` 等命令查看新增的能力,也可以在[插件的参考文档](../../reference/addons/overview)中查看每个官方插件对应的能力.
### 删除/卸载已安装的插件

View File

@ -63,13 +63,13 @@ Addon: fluxcd enabled Successfully.
You can also install addons with some advanced flags.
* Choose one specific version by adding `--version` flag in this command. eg:
* Choose one specific version by adding `--version` flag in this command. e.g:
```shell
vela addon enable fluxcd --version=1.0.0
```
* Choose specific clusters for installation. You can use `--cluster` flag to choose specific clusters. eg:
* Choose specific clusters for installation. You can use `--cluster` flag to choose specific clusters. e.g:
```shell
vela addon enable <addon-name> --clusters={cluster1,cluster2}
@ -77,6 +77,51 @@ vela addon enable <addon-name> --clusters={cluster1,cluster2}
By default, the place for installation is specified as control plane cluster or managed cluster inside the metadata of addon.
* Some addons support setting parts of parameter while enabling. For example `velaux` addon supports change image repository by setting `repo` parameter, then you can change the repo address to your own. e.g:
```shell
vela addon enable velaux repo=<your repo address>
```
### Get addon info
If you want to check the detail status of an addon, or get more available parameters and other useful info of an addon, you can use command `addon status`. For example:
```shell
$ vela addon enable velaux --verbose
velaux: disabled
KubeVela User Experience (UX). An extensible, application-oriented delivery and management Dashboard.
==> Registry Name
KubeVela
==> Available Versions
[v1.4.3, v1.4.2, v1.4.0, v1.4.0-beta.2, v1.3.6, v1.3.4, v1.3.3, v1.3.2, ...]
==> Dependencies ✔
[]
==> Parameters
-> dbType: Specify the database type, current support KubeAPI(default) and MongoDB.
default: "kubeapi"
required: ✔
-> dbURL: Specify the MongoDB URL. it only enabled where DB type is MongoDB.
-> gatewayDriver: Specify the gateway type.
default: "nginx"
required: ✔
-> imagePullSecrets: Specify the names of imagePullSecret for private image registry, eg. "{a,b,c}"
-> serviceType: Specify the service type.
default: "ClusterIP"
required: ✔
-> database: Specify the database name, for the kubeapi db type, it represents namespace.
-> dex: Specify whether to enable the dex
default: "false"
required: ✔
-> domain: Specify the domain, if set, ingress will be created if the gateway driver is nginx.
-> repo: Specify the image hub of velaux, eg. "acr.kubevela.net"
-> serviceAccountName: Specify the serviceAccountName for apiserver
default: "kubevela-vela-core"
required: ✔
```
As above shows, these infos contain the available parameters, available versions, dependent addons and description of and addon.
### Discover the capabilities installed
Once addon installed, end user can discover and use these capabilities immediately.