Deploy Pluggable Components for the Workbench¶

Some features in the Workbench leverage the capabilities of open-source components. Starting from v0.21.0 of the Workbench, a pluggable design pattern is adopted to decouple these functional components. Therefore, when deploying the Workbench, you can choose whether to enable them in the manifest.yaml file of the installer. If they are not enabled during installation, you can follow the instructions below to enable them.

The corresponding functionalities for each component are as follows:

Deploying the argo-cd component¶

If you chose not to enable it during the deployment of DCE 5.0, follow the instructions below to deploy it and use the continuous deployment capability provided by the Workbench.

1. In the DCE 5.0 product module, go to Container Management -> Clusters and enter the details page of the kpanda-global-cluster .

2. In the cluster details page, navigate to the menu on the left side and go to Helm Apps -> Helm Charts -> select the All repository. Search for argo-cd , click it to enter the details page, and install it.

3. On the installation interface, fill in the required installation parameters.

   

   Parameter descriptions:

   • Name: Enter argocd
   • Version: The default version is 5.34.6 , which is the only version available in the addon repository
   • Namespace: Select argocd

   Note

   You can use the default values for the rest of the parameters.

4. Click the OK button at the bottom right to complete the installation. Confirm that the related argo-cd resources in the argocd namespace are all in the Running state.

5. After successfully deploying the resources mentioned above, go to the ConfigMaps & Secrets -> ConfigMaps menu on the left side of the current cluster details page. Search for amamba-config and click Edit YAML .

6. Add the following parameters in the data->amamba-config.yaml section:

   generic:
     argocd:
       host: argocd-server.argocd.svc.cluster.local:80  # argocd server address, format: argocd-server service name.namespace.svc.cluster.local:80
       namespace: argocd  # argocd deployment namespace
   

   

7. After making the changes, go to the Workloads -> Pods menu on the left side of the current cluster details page and search for amamba-apiserver and amamba-syncer . Restart them one by one.

8. Once the restart is successful, you can go to the Workbench module to use the continuous deployment capability.

Notes¶

For the argo-cd component in the addon, we made some configuration changes based on the open-source version. The main changes are as follows:

• Modified the helm template to use the three-part structure of registry:repository:tag for the image, which can be set using global.imageRegistry for the global registry address.
• Modified two configmaps of argo-cd for authentication. These can be installed directly through the argo-cd component in the addon, and no manual operation is required.

[root@demo-dev-master1 ~]# kubectl get cm -n argocd argocd-cm -o 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

Deploying the vela-core component¶

If you chose not to enable it during the deployment of DCE 5.0, follow the instructions below to deploy and utilize the OAM application capabilities provided by the Workbench.

1. In the DCE 5.0 product module, go to Container Management -> Clusters and enter the details page of the kpanda-global-cluster cluster.

2. In the cluster details page, navigate to the left sidebar menu and select Helm Apps -> Helm Charts -> choose the addon repository. Search for vela-core , click it to enter the details page, and proceed with the installation.

3. On the installation page, fill in the required installation parameters:

   

   Parameter explanation:

   • Name: Enter kubevela (recommended)
   • Version: By default, select 1.7.7 as the addon repository only has this version available
   • Namespace: Select vela-system (recommended)

   Note

   • Use the default values for the rest of the parameters.
   • Note that the parameter applicationRevisionLimit indicates the limit on the number of OAM application versions, which is set to 10 by default but can be changed based on your preference.

4. Click the OK button on the bottom right corner to complete the installation. You can check if the relevant workloads under the vela-system namespace are all in the Running state.

5. Once you have confirmed the successful deployment of the above workloads, go to the current cluster's details page and navigate to the left sidebar menu and select ConfigMaps & Secrets -> ConfigMaps . Search for amamba-config and click Edit YAML .

6. In the data->amamba-config.yaml section, add the following parameters:

   generic:
     kubevela:
       namespace: kubevela-system # The namespace where kubevela is installed
   

   

7. After making the changes, go to the left sidebar menu of the current cluster's details page and select Workloads -> Containers . Search for amamba-apiserver and amamba-syncer respectively, and restart them one by one.

8. Once the restart is successful, you can access the Workbench module to utilize the OAM application capabilities.

Deploying the argo-rollouts component¶

If you chose not to enable it during the deployment of DCE 5.0, follow the instructions below to deploy and utilize the gray release capabilities provided by the Workbench.

1. In the DCE 5.0 product module, go to Container Management -> Clusters and enter the details page of the kpanda-global-cluster cluster (the cluster where you want to perform gray releases on applications).

2. In the cluster details page, navigate to the left sidebar menu and select Helm Apps -> Helm Charts -> choose the addon repository. Search for argo-rollouts , click it to enter the details page, and proceed with the installation.

3. On the installation page, fill in the required installation parameters:

   

   Parameter explanation:

   • Name: Enter argorollout (recommended)
   • Version: By default, select 2.32.0 as the addon repository only has this version available
   • Namespace: Select argo-rollouts-system (recommended)

   Note

   Use the default values for the rest parameters.

4. Click the OK button on the bottom right corner to complete the installation. You can check if the relevant workloads under the argo-rollouts-system namespace are all in the Running state.

5. Once the deployment is successful, you can access the Workbench module to utilize the gray release capabilities in the current cluster.

Comments