Deploying Addons

Once you have created the addons, you can enable (deploy) them in your cluster. Before deploying, you must first configure the addon.

Step 1: Configure Addon

To configure an addon, follow these steps:

1. In the Addons tab in your ArgoCD instance, click on the addon you wish to configure.

   

2. In the addon details view, click the Configure button.

   

3. Configure the addon options:

   1. Template Name: The templated name of the addon.

   2. Template Namespace: The templated namespace where the addon will be deployed.

   3. Template Project: The templated project where the addon will be deployed.

   Template Syntax

   You can use the following allowed template expressions to dynamically configure your addon:

   • Addon Fields:
   • {{ .addon.name }} — The name of the addon.
   • {{ .addon.type }} — The type of the addon.
   • Cluster Fields:
   • {{ .cluster.name }} — The cluster's name.
   • {{ .cluster.namespace }} — The cluster's namespace.
   • {{ .cluster.labels }} — The cluster's labels.
   • {{ .cluster.annotations }} — The cluster's annotations.
   4. Creation Options: Configure the creation details for the addon.
   5. Auto Sync Options:
      • Auto Sync: Enable automatic synchronization of the addon.
      • Auto Heal: Enable automatic healing of the addon.
      • Prune Resources: Enable automatic pruning of resources.
   6. Sync Options:
      • Skip Schema Validation: Skip schema validation.
      • Auto-Create Namespace: Automatically create the namespace if it does not exist.
      • Prune Last: Prune the last remaining resources.
      • Apply Out of Sync Only: Apply changes only when the addon is out of sync.
      • Respect Ignore Differences: Respect the ignore differences configuration.
      • Server-Side Apply: Use Kubernetes Server-Side Apply.
      • Replace: Replace existing resources during sync.
   7. Prune Propagation Policy: Set the prune propagation policy.
   8. Deployment Options: Configure the addon deployment details based on its type:
      • Helm Options:
        • Source Values: Specify the source values for the addon.
        • Release Name Template: Define the release name template.
      • Kustomize Options:
        • Name Prefix Template: Define the name prefix template.
        • Name Suffix Template: Define the name suffix template.
   9. Filters: Control which clusters receive the addon:
      • All Clusters: Deploy the addon to all connected clusters.
      • Selected Clusters: Deploy the addon to selected clusters based on name and label filters.

4. Click Save to store the configuration.

   

Step 2: Enable/Deploy Addon

After configuring the addon, enable (deploy) it in your cluster by following these steps:

1. In the Addons tab, select the addon you wish to enable.

   

2. In the addon details view, click the Enable button. Confirm the action by clicking Enable in the confirmation dialog.

   

3. Navigate to the Summary tab for your addon. Here, you can view the current sync status. If auto-sync is not enabled, click the Sync button to synchronize the addon with your cluster.

   

4. The addon will now be deployed in your cluster.

Enable Kustomize

To use Kustomize for incorporating Helm charts in your addons, enable Kustomize in your ArgoCD instance as follows:

1. Open your instance settings and click on the Manifest Generation tab.

2. In the Kustomize section, enable the Enabled option and add the following build options:

   --enable-helm --helm-kube-version=1.30

3. Click Save to apply the settings.

   

Cluster Customization

You can patch the application spec of an addon to make cluster-specific changes. To patch the application spec, follow these steps:

1. In the Addons tab, select the addon you wish to patch.

2. Go to the Cluster Customization tab.

3. Click on the New Customization button to add a new patch.

   

4. Select the target cluster, enter the patch details, and click Add to apply the patch.

   

Update Manifest Source

You can update the manifest source for an addon to implement environment or cluster-specific changes. To update the manifest source, follow these steps:

1. In the Addons tab, select the addon you want to update.

2. Navigate to the Manifest Source tab.

3. Click on the Settings icon next to the manifest source you wish to update.

   

4. Update the image details and Helm chart details as needed, then click Update.

   

In this way, you can deploy and manage addons in your cluster using ArgoCD. In the next section, we will cover how to delete addons from the cluster.