Alauda Container Platform GitOps Docs
  • English

    • Installing Alauda Build of Argo CD

    INFO

    Starting in ACP 4.5, Alauda Build of Argo CD is named Alauda Container Platform GitOps Controller. Search for Alauda Container Platform GitOps Controller when you download the plugin from the Customer Portal. A plugin package published before the rename still shows Alauda Build of Argo CD in the platform after you upload it.

    TOC

    PrerequisitesProcedureInstall Alauda Build of Argo CD OperatorCreate Argo CD InstanceCreate AppProject Instance

    Prerequisites

    1. Download the Alauda Container Platform GitOps Controller Operator (previously Alauda Build of Argo CD) installation package corresponding to your platform architecture.
    2. Upload the installation package using the Upload Packages mechanism.

    Procedure

    Install to the cluster where you want to use GitOps functionality.

    Install Alauda Build of Argo CD Operator

    1. Login, go to the Administrator page.
    2. Click Marketplace > OperatorHub to enter the OperatorHub page.
    3. Find the Alauda Container Platform GitOps Controller Operator (shown as Alauda Build of Argo CD for a package published before the rename), click Install, and navigate to the Install Argo CD page.

    Configuration Parameters:

    ParameterRecommended Configuration
    ChannelThe default channel is alpha.
    Installation ModeCluster: All namespaces in the cluster share a single Operator instance for creation and management, resulting in lower resource usage.
    NamespaceSelect Recommended Namespace: Automatically created if none exists.
    Upgrade StrategyAuto: The OperatorHub will automatically upgrade the Operator to the latest version when a new version is available.
    1. It is recommended to use the suggested default configuration; simply click Install to complete the Alauda Container Platform GitOps Controller Operator (previously Alauda Build of Argo CD) installation.

    Create Argo CD Instance

    1. Click Marketplace > OperatorHub.

    2. Find the Alauda Container Platform GitOps Controller Operator (shown as Alauda Build of Argo CD for a package published before the rename), click it to enter the Argo CD detail info page.

    3. Click All Instances,

    4. Click Create Instance, select Argo CD instance card.

    5. Click Create Instance

    INFO

    In the configuration instance parameter page, use the default configuration unless there are specific requirements. Note: If the global cluster is not highly available (e.g., it has only one control node), please switch to YAML view when creating the instance and set the ha.enabled field value to false.

    1. Click Create.

    Create AppProject Instance

    INFO

    Tip: If you do not need to use the platform-managed Cluster Configuration Management feature, you do not need to perform the following steps.

    1. Find the Alauda Container Platform GitOps Controller operator (shown as Alauda Build of Argo CD for a package published before the rename), click it to enter the Alauda Argo CD detail info page.

    2. Click All Instances, Create Instance, select AppProject instance card.

    3. Switch to YAML view, and overwrite the existing YAML content on the interface with the code below.

      apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
  name: cpaas-system
  namespace: argocd
spec:
  clusterResourceWhitelist:
  - group: '*'
    kind: '*'
  destinations:
  - namespace: '*'
    server: '*'
  sourceRepos:
  - '*'

    4. Click Create.

    After completing the above procedure, you have successfully installed Argo CD. Immediately Creating an Argo CD Application via Argo CD dashboard to begin your GitOps journey.