[draft]docs: add applicationset configuration

docs/zh/docs/amamba/user-guide/gitops/applicationset.md

@@ -0,0 +1,128 @@
+# 使用 ApplicationSet
+
+ArgoCD 支持使用 [ApplicationSet](https://argo-cd.readthedocs.io/en/stable/user-guide/application-set/) 的方式来灵活的生成多个 GitOps 应用，例如多集群应用场景，应用工作台中使用 `AppOfApplicationSet` 的方式来进行支持。本文将指导您如何在应用工作台中启用 ApplicationSet 功能。
+
+!!! note
+
+    本文假设您的ArgoCD 安装的命名空间和Helm Release名称均为 argocd。这将会影响到后续的搜索和修改操作，如果您的命名空间和Release名称不同，请自行替换。
+
+## AppOfApplicationSet模式
+
+`AppOfApplicationSet` 是 GitOps的一种运维模式，通过 Application -> 生成ApplicationSet -> 生成多个Application 的方式来实现多集群应用的部署。 效果如图：
+![applicationset](../../images/gitops-application-set.png)
+
+因此本质上还是创建的 GitOps Application。前提是您的 GitOps 仓库(假设您的仓库名称为 app-set-repo) 中需要包含一份 ApplicationSet 的定义文件。如下所示：
+
+```yaml
+apiVersion: argoproj.io/v1alpha1
+kind: ApplicationSet # 资源类型为 ApplicationSet
+metadata:
+  name: guestbook # 注意不要定义namespace，否则无法正常创建
+spec:
+  generators:
+    - list:
+        elements: # 自定义的元素，是一个map结构，可以任意添加，会被go template的形式替换
+          - cluster: "cluster1"
+            namespace: "ns1"
+            path: "dev"
+          - cluster: "cluster2"
+            namespace: "ns2"
+            path: "staging"
+  template: # 本质上是渲染出一个ArgoCD的 Application 资源
+    metadata:
+      name: "{{cluster}}-2048" # 在template中可以使用上述generators中定义的元素
+    spec:
+      project: "2" # 代表工作空间的ID
+      source:
+        repoURL: https://demo-repo.git # 真实创建 Application 的仓库地址，上述elements中的path应该与此URL对应的仓库对应
+        targetRevision: HEAD
+        path: "{{path}}"
+      destination:
+        name: "{{cluster}}"
+        namespace: "{{namespace}}"
+```
+
+> 注意 Application 中的集群和命名空间需要提前在【全局管理】模块中进行绑定。project, cluster, namespace请按权限填写，否则会导致创建失败。
+
+后续需要在应用工作台的 GitOps 模块创建一个GitOps Application，其中的仓库地址为 app-set-repo对应的地址，即可生成多个 Application。如何创建GitOps应用请看[创建 GitOps 应用](create-argo-cd.md)。
+
+请按照下面的步骤来启用 ApplicationSet 功能。
+
+## 启用 ApplicationSet 功能
+
+1. 配置 ApplicationSet Controller 的RBAC
+
+   ApplicationSet 依赖于ApplicationSet Controller的调谐才能实现控制多个Application，需要在集群中配置相应的 RBAC 角色(默认情况下不会创建，需要手动创建)。分为两种情况：
+
+- 如果您已经安装了ArgoCD
+
+  默认情况下，通过 helm安装的ArgoCD 不会创建 ApplicationSet Controller 的ClusterRole和ClusterRoleBinding，您需要手动创建。 推荐通过更新 Helm 应用的方式。
+
+  前往 **容器管理** -> **集群列表** -> **kpanda-global-cluster** -> **Helm应用** -> 搜索 `argocd`（您安装ArgoCD时的Helm应用名称），点击右侧 **更新**，在表单中开启argcd.applicationSet.allowAnyNamespace选项，如下：
+
+  ![update-argocd](../../images/argocd-helm-any-ns.png)。
+
+  当然也可以通过values.yaml来设置：
+
+  ```yaml
+  argo-cd:
+    applicationSet:
+      allowAnyNamespace: true
+  ```
+
+  除此之外，您也可以选择在 `kpanda-global-cluster` 集群上通过命令行的方式创建:
+
+  ```shell
+  kubectl apply https://github.com/argoproj/argo-cd/blob/master/manifests/cluster-rbac/applicationset-controller/argocd-applicationset-controller-clusterrole.yaml
+  kubectl apply https://github.com/argoproj/argo-cd/blob/master/manifests/cluster-rbac/applicationset-controller/argocd-applicationset-controller-clusterrolebinding.yaml
+  ```
+
+- 如果您未安装ArgoCD
+
+  在安装时通过设置 `argocd.applicationSet.allowAnyNamespace` 为 `true` 来创建RBAC资源。
+
+1. 修改ArgoCD相关的ConfigMap配置
+
+   前往 **容器管理** -> **集群列表** -> **kpanda-global-cluster** -> **配置与密钥** -> **配置项**, 此处需要修改以下两个configmap，因为需要添加内容，请选择 **编辑yaml** 的形式进行修改
+
+- argocd-cm
+
+  在yaml的data字段中添加如下配置：
+
+  ```yaml
+  kind: ConfigMap
+  apiVersion: v1
+  metadata:
+    name: argocd-cm
+  data:
+    application.resourceTrackingMethod: "annotation+label" # 添加这一行
+  ```
+
+- argocd-cmd-params-cm
+  在yaml的data字段中添加或修改如下配置：
+
+  ```yaml
+  kind: ConfigMap
+  apiVersion: v1
+  metadata:
+    name: argocd-cmd-params-cm
+  data:
+    # 添加下面这三行
+    application.namespaces: "gitops-*"
+    applicationsetcontroller.namespaces: "gitops-*"
+    applicationsetcontroller.allowed.scm.providers: "true"
+  ```
+
+  完成上述更改后，您需要重启ArgoCD和Amamba相关组件。
+
+## 重启服务
+
+重启ArgoCD组件：
+
+前往 前往 **容器管理** -> **集群列表** -> **kpanda-global-cluster** -> **工作负载** -> **无状态负载** -> 命名空间选 `argocd` (您安装ArgoCD的命名空间) -> 搜索 `argocd-applicationset-controller` -> 点击右侧 **┇** 中的 **状态** 进行重启。同时在 **有状态负载** -> 搜索 `argocd-application-controller`，将其重启。
+
+重启Amamba组件：
+
+前往 **容器管理** -> **集群列表** -> **kpanda-global-cluster** -> **工作负载** -> **无状态负载** ，选择命名空间 `amamba-system`，分别重启 `amamba-apiserver` 和 `amamba-syncer` 这两个 Deployment。
+
+等待上述组件重启完成后，前往应用工作台创建 GitOps 应用时选择 `AppOfApplicationSet`的方式创建即可。