# 部署应用工作台可插拔组件

应用工作台中的一些功能借助了开源组件的能力，从应用工作台 v0.21.0 版本开始，采取可插拔的设计模式，解藕了相关的功能组件，
所以在部署应用工作台时，您可以在安装器的 __manifest.yaml__ 文件中选择是否开启。如果安装时没有开启，您也可以通过下文指导进行启用。

关于每个组件的对应的功能如下：

|  组件   | 功能  |  备注 ｜
|  ----  | ----  | ---- |
| argo-cd  | 持续部署 | 安装时默认安装 ｜
| argo-rollouts  | 灰度发布 | 安装时默认不安装 |
| vela-core  | OAM 应用 | 安装时默认不安装 |

!!! note

    如果需要在安装 DCE 5.0 时开启或关闭应用工作台的相关组件，可以在部署时设置 __manifest.yaml__
    中的 __enable__ 关键字来通过设置 true 或者 fasle 选择是否启用。

## 部署 argo-cd 组件

如果部署 DCE 5.0 时选择不启用，则按照下述步骤进行部署，从而使用应用工作台提供的持续部署能力。

1. 在 DCE 5.0 产品模块，进入 __容器管理__ -> __集群列表__，进入 __kpanda-global-cluster__ 集群详情页面。

2. 在集群详情中左侧菜单栏的 __Helm 应用__ -> __Helm 模板__ -> 选择全部仓库。搜索 __argo-cd__，点击进入详情页面并安装。

3. 在安装界面，填写所需要的安装参数

    ![argocd01](https://docs.daocloud.io/daocloud-docs-images/docs/zh/docs/amamba/images/argocd01.png)

    参数说明：

    - 名称：请填写 __argocd__，建议。
    - 版本：默认选择为 __5.34.6__，addon 仓库目前仅有该版本。
    - 命名空间：选择 __argocd__，建议。

    !!! note

        其余参数均使用默认值即可。

4. 点击右下角确定按钮即可完成安装。可以查看 __argocd__ 命名空间下的 argocd 相关的负载是否均处于 __运行中__ 状态判断。

5. 确认上述的负载成功部署后，在当前集群切换到 __amamba-system__ 命名空间并点击左侧菜单栏的
   __配置项与密钥__ -> __配置项__，搜索 __amamba-config__，点击 __编辑 YAML__。

6. 在 __data__ -> __amamba-config.yaml__ 中添加如下参数：

    ```yaml
    generic:
      argocd:
        host: argocd-server.argocd.svc.cluster.local:80  # (1)!
        namespace: argocd  # (2)!
    ```

    1. argocd 的服务地址，格式为：argocd-server 的服务名。命名空间.svc.cluster.local:80
    2. argocd 安装的命名空间

    ![argocd02](https://docs.daocloud.io/daocloud-docs-images/docs/zh/docs/amamba/images/argocd02.png)

7. 修改完成后，在当前集群详情左侧菜单栏的 __工作负载__ -> __容器组__，分别搜索
   __amamba-apiserver__、__amamba-syncer__，并依次进行重启。

8. 重启成功后，即可前往 __应用工作台__ 模块使用持续部署能力。

### 注意事项

对于 Addon 中的 argo-cd 组件，我们基于开源版本做了一些配置，主要更改如下：

- 修改 helm template 中的 image 改为 `registry:repository:tag` 的三段式结构，可以通过 global.imageRegistry 来设置全局的仓库地址
- 修改了 argo-cd 的下面两个 configmap，用以鉴权，这部分直接安装 addon 中的 argo-cd 即可，不需要手动操作

```shell
[root@demo-dev-master1 ~]# kubectl get cm -n argocd argocd-cm -o yaml
```
```yaml
apiVersion: v1
data:
  accounts.amamba: apiKey
  admin.enabled: "true"
kind: ConfigMap
metadata:
  name: argocd-cm

[root@demo-dev-master1 ~]# kubectl get cm -n argocd argocd-rbac-cm -o yaml
apiVersion: v1
data:
  policy.csv: |
    g, amamba, role:admin
  policy.default: ""
  scopes: '[groups]'
kind: ConfigMap
metadata:
  name: argocd-rbac-cm
```

## 部署 vela-core 组件

如果部署 DCE 5.0 时选择不启用，则按照下述步骤进行部署，从而使用应用工作台提供的 OAM 应用能力。

1. 在 DCE 5.0 产品模块，进入 __容器管理__ -> __集群列表__，进入 __kpanda-global-cluster__ 集群详情页面。

2. 在集群详情中左侧菜单栏的 __helm 应用__ -> __helm 模板__ -> 选择 addon 仓库。搜索 __vela-core__，点击进入详情页面并安装。

3. 在安装界面，填写所需要的安装参数

    ![vela01](https://docs.daocloud.io/daocloud-docs-images/docs/zh/docs/amamba/images/vela01.png)

    参数说明：

    - 名称：请填写 __kubevela__
    - 版本：默认选择为 __1.7.7__，addon 仓库目前仅有该版本
    - 命名空间：请选择 __vela-system__

    !!! note

        - 其余参数均使用默认值即可。
        - 注意：__applicationRevisionLimit__ 这个参数表示 OAM 应用版本的数量限制，默认是 10，可根据选择是否更改。

4. 点击右下角确定按钮即可完成安装。可以查看 __vela-system__ 命名空间下的相关的负载是否均处于 __运行中__ 状态判断。

5. 确认上述的负载成功部署后，在当前集群详情左侧菜单栏的 __配置项与密钥__ -> __配置项__，
   搜索 __amamba-config__，点击 __编辑 YAML__。

6. 在 __data->amamba-config.yaml__ 中添加如下参数：

    ```yaml
    generic:
      kubevela:
        namespace: kubevela-system # (1)!
    ```

    1. kubevela 安装的命名空间

    ![vela02](https://docs.daocloud.io/daocloud-docs-images/docs/zh/docs/amamba/images/vela02.png)

7. 修改完成后，在当前集群详情左侧菜单栏的 __工作负载__ -> __容器__，分别搜索 __amamba-apiserver__、
   __amamba-syncer__，并依次进行重启。

8. 重启成功后，即可前往 __应用工作台__ 模块使用 OAM 应用能力。

## 部署 argo-rollouts

如果部署 DCE 5.0 时选择不启用，则按照下述步骤进行部署，从而使用应用工作台提供的灰度发布能力。

1. 在 DCE 5.0 产品模块，进入 __容器管理__ -> __集群列表__，进入 __kpanda-global-cluster__
   集群详情页面（选择部署在应用进行灰度发布的集群中）。

2. 在集群详情中左侧菜单栏的 __helm 应用__ -> __helm 模板__ -> 选择 addon 仓库。
   搜索 __argo-rollouts__，点击进入详情页面并安装。

3. 在安装界面，填写所需要的安装参数

    ![argorolllout01](https://docs.daocloud.io/daocloud-docs-images/docs/zh/docs/amamba/images/argorollout01.png)

    **参数说明：**

    - 名称：请填写 __argorollout__，建议。
    - 版本：默认选择为 __2.32.0__，addon 仓库目前仅有该版本。
    - 命名空间：请选择 __argo-rollouts-system__，建议。

    **开启 contour**

    应用工作台在新版本 v0.24.0 支持了基于 contour 的流量控制的灰度发布策略，如果需要使用该能力，需要执行如下事项：

    - 定义 `value.yaml` 中的 `initContainers` 字段下的参数：

        ```yaml
        argo-rollouts:
          controller:
            initContainers:                                    
              - name: copy-contour-plugin
                image: release.daocloud.io/skoala/rollouts-plugin-trafficrouter-contour:v0.3.0 # (1)!
                command: ["/bin/sh", "-c"]                    
                args:
                  - cp /bin/rollouts-plugin-trafficrouter-contour /plugins
                volumeMounts:                                  
                  - name: contour-plugin
                    mountPath: /plugins
            trafficRouterPlugins:                              
              trafficRouterPlugins: |-
                - name: argoproj-labs/contour
                  location: "file:///plugins/rollouts-plugin-trafficrouter-contour" 
            volumes:                                           
              - name: contour-plugin
                emptyDir: {}
            volumeMounts:                                      
              - name: contour-plugin
                mountPath: /plugins
        ```

        1. 离线化时需要在镜像地址前增加离线化镜像仓库地址

    - 在argo-rollouts 安装完成后，还需要执行一下命令去修改clusterRole：

        ```shell
        # clusterRole的名称需要根据实际的安装情况来修改。
        kubectl patch clusterrole argo-rollouts --type='json' -p='[{"op": "add", "path": "/rules/-", "value": {"apiGroups":["projectcontour.io"],"resources":["httpproxies"],"verbs":["get","list","watch","update","patch","delete"]}}]'
        ```

    Rollout 部署成功后，可以创建金丝雀发布界面选择 contour 作为流量控制。

4. 点击右下角确定按钮即可完成安装。可以查看 __argo-rollouts-system__ 命名空间下的相关的负载是否均处于 __运行中__ 状态判断。

5. 部署成功后，即可前往 __应用工作台__ 模块在当前集群使用`基于云原生网关`的灰度发布能力。

    ![contour](images/contour01.png)

!!! note

    - argo-rollout 是一个用于 Kubernetes 应用的灰度发布和流量管理的工具，它专注于应用程序的部署和更新过程。
    - 在使用过程中，需要在应用的所在集群部署。如果需要在多个集群中使用灰度发布能力，需要在所对应的集群一一部署 argo-rollout 组件。