From 14722106ff87f3ce2598e076d0e5a1b1b3affbf7 Mon Sep 17 00:00:00 2001
From: Somefive <Somefive@foxmail.com>
Date: Thu, 23 Sep 2021 19:03:58 +0800
Subject: [PATCH] Docs: add guide for enable multicluster (#296)

* Docs: add guide for enable multicluster

* Docs: move multicluster to advance install
---
 docs/platform-engineers/advanced-install.mdx    | 17 +++++++++++++++++
 .../platform-engineers/advanced-install.mdx     | 17 +++++++++++++++++
 .../platform-engineers/advanced-install.mdx     | 16 ++++++++++++++++
 .../platform-engineers/advanced-install.mdx     | 17 +++++++++++++++++
 4 files changed, 67 insertions(+)

diff --git a/docs/platform-engineers/advanced-install.mdx b/docs/platform-engineers/advanced-install.mdx
index 49160834..4e1820f3 100644
--- a/docs/platform-engineers/advanced-install.mdx
+++ b/docs/platform-engineers/advanced-install.mdx
@@ -173,6 +173,23 @@ vela addon disable fluxcd
 Please remove all application using this addon before disable it.
 
 
+## Multi-Cluster Management
+
+KubeVela can orchestrate applications across multiple Kubernetes clusters. This capability is enabled by default, but you can enable it manually by running the following command:
+
+```shell
+helm upgrade --install kubevela kubevela/vela-core -n vela-system --set multicluster.enabled=true --create-namespace --wait
+```
+
+Verify that multi-cluster is enabled:
+
+```shell
+> kubectl get APIService v1alpha1.cluster.core.oam.dev
+NAME                            SERVICE                                        AVAILABLE   AGE
+v1alpha1.cluster.core.oam.dev   vela-system/kubevela-cluster-gateway-service   True        7h40m
+```
+
+
 ## Clean Up
 
 Run:
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/platform-engineers/advanced-install.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/platform-engineers/advanced-install.mdx
index 32a9316d..fd86de3b 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/platform-engineers/advanced-install.mdx
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/platform-engineers/advanced-install.mdx
@@ -142,6 +142,23 @@ kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/release-1.1/
 helm upgrade --install --create-namespace --namespace vela-system  kubevela kubevela/vela-core --version <the_new_version> --wait
 ```
 
+
+## 启用多集群管理
+
+KubeVela 提供了跨集群编排应用的能力。上文的安装命令已经启用了该功能，如果你是从旧版本 KubeVela 升级上来，或是在安装时没有选用多集群管理的能力，你可以运行以下命令启用该能力
+
+```shell
+helm upgrade --install kubevela kubevela/vela-core -n vela-system --set multicluster.enabled=true --create-namespace --wait
+```
+
+你可以运行以下命令来检查多集群功能是否正常启用。
+```shell
+> kubectl get APIService v1alpha1.cluster.core.oam.dev
+NAME                            SERVICE                                        AVAILABLE   AGE
+v1alpha1.cluster.core.oam.dev   vela-system/kubevela-cluster-gateway-service   True        7h40m
+```
+
+
 ## 插件列表
 
 | 插件                  | 简介                                              | 对应的内置功能        | 插件对应开源项目                                        |
diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-v1.1/platform-engineers/advanced-install.mdx b/i18n/zh/docusaurus-plugin-content-docs/version-v1.1/platform-engineers/advanced-install.mdx
index 32a9316d..2ea674f6 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/version-v1.1/platform-engineers/advanced-install.mdx
+++ b/i18n/zh/docusaurus-plugin-content-docs/version-v1.1/platform-engineers/advanced-install.mdx
@@ -175,6 +175,22 @@ vela addon disable fluxcd
 禁用前请先清理使用插件功能的应用，否则将禁用失败。
 
 
+## 启用多集群管理
+
+KubeVela 提供了跨集群编排应用的能力。上文的安装命令已经启用了该功能，如果你是从旧版本 KubeVela 升级上来，或是在安装时没有选用多集群管理的能力，你可以运行以下命令启用该能力
+
+```shell
+helm upgrade --install kubevela kubevela/vela-core -n vela-system --set multicluster.enabled=true --create-namespace --wait
+```
+
+你可以运行以下命令来检查多集群功能是否正常启用。
+```shell
+> kubectl get APIService v1alpha1.cluster.core.oam.dev
+NAME                            SERVICE                                        AVAILABLE   AGE
+v1alpha1.cluster.core.oam.dev   vela-system/kubevela-cluster-gateway-service   True        7h40m
+```
+
+
 ## 卸载
 
 运行命令:
diff --git a/versioned_docs/version-v1.1/platform-engineers/advanced-install.mdx b/versioned_docs/version-v1.1/platform-engineers/advanced-install.mdx
index 49160834..4e1820f3 100644
--- a/versioned_docs/version-v1.1/platform-engineers/advanced-install.mdx
+++ b/versioned_docs/version-v1.1/platform-engineers/advanced-install.mdx
@@ -173,6 +173,23 @@ vela addon disable fluxcd
 Please remove all application using this addon before disable it.
 
 
+## Multi-Cluster Management
+
+KubeVela can orchestrate applications across multiple Kubernetes clusters. This capability is enabled by default, but you can enable it manually by running the following command:
+
+```shell
+helm upgrade --install kubevela kubevela/vela-core -n vela-system --set multicluster.enabled=true --create-namespace --wait
+```
+
+Verify that multi-cluster is enabled:
+
+```shell
+> kubectl get APIService v1alpha1.cluster.core.oam.dev
+NAME                            SERVICE                                        AVAILABLE   AGE
+v1alpha1.cluster.core.oam.dev   vela-system/kubevela-cluster-gateway-service   True        7h40m
+```
+
+
 ## Clean Up
 
 Run: