This is an automated email from the ASF dual-hosted git repository.
albumenj pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/master by this push:
new cf2168e99f Update dubboctl module (#2516)
cf2168e99f is described below
commit cf2168e99f8665624d5f3f118799d805dd76adb5
Author: Scout Wang <[email protected]>
AuthorDate: Thu Apr 13 21:07:19 2023 +0800
Update dubboctl module (#2516)
---
.../zh-cn/overview/reference/admin/architecture.md | 97 +++++++++++++++++++---
1 file changed, 85 insertions(+), 12 deletions(-)
diff --git a/content/zh-cn/overview/reference/admin/architecture.md
b/content/zh-cn/overview/reference/admin/architecture.md
index 1417d0c346..ceca4d9ff2 100644
--- a/content/zh-cn/overview/reference/admin/architecture.md
+++ b/content/zh-cn/overview/reference/admin/architecture.md
@@ -22,36 +22,109 @@ weight: 1
### Dubboctl 安装
#### Download
-下载 Dubbo Admin 发行版本
+当前Dubboctl未正式发行，可按以下方式进行尝试。
+拉取Dubbo Admin并编译Dubboctl
```shell
-curl -L https://dubbo.apache.org/installer.sh | VERSION=0.1.0 sh -
-# Admin 要组织好发行版本
+git clone https://github.com/apache/dubbo-admin.git
+cd dubbo-admin/cmd/dubboctl
+go build -o dubboctl .
```
将 dubboctl 放入可执行路径
```shell
-ln -s dubbo-admin-0.1.0/bin/dubboctl /usr/local/bin/dubboctl
+ln -s dubbo-admin/cmd/dubboctl/dubboctl /usr/local/bin/dubboctl
```
#### Install
安装过程会依次：
-1. 安装 Admin 自定义的一些资源
-2. 拉起 Admin、Nacos、Zookeeper 等不同的组件服务
+1. 将用户自定义的配置profile以及set参数覆盖于默认profile，得到最终的profile
+```yaml
+# default profile
+apiVersion: dubbo.apache.org/v1alpha1
+kind: DubboOperator
+metadata:
+ namespace: dubbo-system
+spec:
+ profile: default
+ namespace: dubbo-system
+ componentsMeta:
+ admin:
+ enabled: true
+ grafana:
+ enabled: true
+ repoURL: https://grafana.github.io/helm-charts
+ version: 6.52.4
+ nacos:
+ enabled: true
+ zookeeper:
+ enabled: true
+ repoURL: https://charts.bitnami.com/bitnami
+ version: 11.1.6
+ prometheus:
+ enabled: true
+ repoURL: https://prometheus-community.github.io/helm-charts
+ version: 20.0.2
+ skywalking:
+ enabled: true
+ repoURL: https://apache.jfrog.io/artifactory/skywalking-helm
+ version: 4.3.0
+ zipkin:
+ enabled: true
+ repoURL: https://openzipkin.github.io/zipkin
+ version: 0.3.0
+```
+建议使用自定义profile进行配置，在componentsMeta中开启或关闭组件，在components下配置各组件。其中components下各组件的配置值都是helm
chart的values，各组件的具体配置请参考：
+Grafana:
https://github.com/grafana/helm-charts/blob/main/charts/grafana/README.md
+Zookeeper:
https://github.com/bitnami/charts/tree/main/bitnami/zookeeper/#installing-the-chart
+Prometheus:
https://github.com/prometheus-community/helm-charts/tree/main/charts
+Skywalking:
https://github.com/apache/skywalking-kubernetes/blob/master/chart/skywalking/README.md
+Zipkin: https://github.com/Financial-Times/zipkin-helm
+```yaml
+# customization profile
+apiVersion: dubbo.apache.org/v1alpha1
+kind: DubboOperator
+metadata:
+ namespace: dubbo-system
+spec:
+ profile: default
+ namespace: dubbo-system
+ componentsMeta:
+ admin:
+ enabled: true
+ grafana:
+ enabled: true
+ version: 6.31.0
+ prometheus:
+ enabled: false
+ components:
+ admin:
+ replicas: 3
+ grafana:
+ testFramework:
+ enabled: false
+```
+2.
根据profile拉取所需组件并生成manifest，目前Admin，Nacos已在本地，无需拉取；Grafana，Zookeeper，Prometheus，Skywalking，Zipkin将从官方chart库拉取，具体地址和版本可见上方default
profile
+3. 将manifest应用于k8s集群
```shell
-dubboctl install # 使用默认 manifests 安装
+dubboctl manifest install # 使用默认 manifests 安装
# or
-dubboctl manifests| kubectl apply -f -
+dubboctl manifest generate | kubectl apply -f -
```
```shell
-dubboctl install --set profile=minimal # 指定不同的 profile，即安装组件的组合
+dubboctl install --set spec.components.admin.replicas=2 # 设置组件的配置
```
```shell
-dubboctl install --set admin.nacos.enabled=true, admin.nacos.namespace=test
-# 指定不同的覆盖参数
+dubboctl install --set spec.componentsMeta.admin.enabled=true,
spec.componentsMeta.grafana.enabled=false
+# 开启或关闭组件
+```
+
+```shell
+dubboctl install --set
spec.componentsMeta.grafana.repoURL=https://grafana.github.io/helm-charts,
spec.componentsMeta.grafana.version=6.31.0
+# 设置需远程拉取组件的仓库地址与版本
```
检查安装效果
@@ -216,4 +289,4 @@ external-services:
```
#### 打开 Admin 控制台
-打开浏览器，访问： `http://127.0.0.1:38080/`
\ No newline at end of file
+打开浏览器，访问： `http://127.0.0.1:38080/`
