Creating Addons

Cluster addons can be created in two ways:

1. Marketplace wizard
2. Manually creating the repository

Before creating cluster addons, ensure that you have connected the addons Git repository.

Step 1: Add Addons Repository

The addons repository contains the addons for the cluster. There are two ways to add an addons repository:

Option 1: Connect Existing Addons Repo

If you already have a repository added to Argo CD that you want to use for cluster addons:

1. Go to your ArgoCD instance and click on the Addons tab.

2. Click the Connect Addons Repo button.

   

3. In the modal that opens, select the repository from the list of existing Argo CD repositories and enter the branch, then click Connect.

   important

   The repository credentials must have write access to the repository for features like marketplace operations, manifest source updates, and deletions to work properly.

Option 2: Add New Addons Repo

If you want to create a new repository from scratch:

1. Go to your ArgoCD instance and click on the Addons tab.

2. Click the + Add Addons Repo button.

   

3. In the modal that opens, you'll see two tabs:

   • Form: Use the form interface to configure the repository
   • JSON Editor: Use JSON format for advanced configuration

4. In the Form tab, configure the repository connection:

   • Connection Method: Select your preferred connection method from the dropdown (e.g., HTTPS, SSH, etc.)
   • Repository URL: Enter the Git repository URL
   • Credentials: Provide authentication details based on your connection method:
     • For HTTPS: Username and password/token
     • For SSH: SSH private key
   • Additional Settings: Configure any other required parameters specific to your repository

5. Click Add to create the repository. The corresponding repository will be automatically added to Argo CD and connected as a cluster addon repository.

Step 2: Create Addons

Once the addons repository is connected, you can create cluster addons using the marketplace wizard or manually.

Marketplace

The Cluster Addons Marketplace is a curated catalog of ready-to-deploy applications for Kubernetes clusters. With just a few clicks, users can deploy multiple addons to all their configured clusters with no complex setup required. From monitoring to security and developer tools, the marketplace streamlines deployments and boosts efficiency.

To create a cluster addon using the marketplace wizard, follow these steps:

1. Ensure that the addons repository is connected.

2. Click the Addons tab in your ArgoCD instance and then click Explore Addon Marketplace button.

   

3. View the list of available addons. Choose the addon you wish to add, click the Add button, and then click Next.

   

4. In the Edit packages details section, review the marketplace dependencies that have been added:

   • Marketplace dependencies: Change the version of the added dependencies.
   • Custom dependencies: Add custom dependencies if required (provide Name, Version, and Repository URL).

   Click Next.

5. In the Choose repository and add metadata section, provide:

   • Repository: Choose the Git repository and branch where you want to add the addon.
   • Helm chart metadata: Enter the Name, Version, and Description.
   • Additional overrides: Add any overrides if needed (for example, cluster or environment overrides).

   Click Finish.

6. The addon is created in the selected repository.

   

Reinstalling Marketplace Addons

If an addon is deleted from the Git repository, you can reinstall it to update the addon in the cluster. You can also delete marketplace addons directly from the platform interface.

note

When deleting a marketplace addon from the platform, the action will delete the addon marketplace installation data (which can be used for addon reinstallation) and also delete Git repository data related to this addon name.

Follow these steps:

1. Go to the Addons tab in your ArgoCD instance and look for the addon you wish to reinstall. These addons will be marked with a Uninstalled status.

2. Find the addon you wish to reinstall and click the Reinstall button.

   

The addon will be reinstalled in the cluster.

Manually Creating Addons

INFO

Cluster Addons supports two types of manifest generation tools: Helm charts and Kustomize overlays. Choose the option that best suits your deployment requirements.

To manually create cluster addons, follow these steps:

1. Ensure that the addons repository is connected.

2. Organize your repository with the following directory structure:

   <addons-repo>
   ├── addons
   │   ├── <helm-addon-name>
   │   │   ├── Chart.yaml
   │   │   ├── values.yaml
   │   ├── <kustomize-addon-name>
   │   │   ├── kustomization.yaml
   │   │   ├── <resource1>.yaml
   │   │   ├── <resource2>.yaml
   ├── clusters
   │   ├── <cluster-name>
   │   │   ├── <helm-addon-name>
   │   │   │   ├── values.yaml
   │   │   ├── <kustomize-addon-name>
   │   │   │   ├── kustomization.yaml
   ├── envs
   │   ├── <env-name>
   │   │   ├── <helm-addon-name>
   │   │   │   ├── values.yaml
   │   │   ├── <kustomize-addon-name>
   │   │   │   ├── kustomization.yaml

   • addons: Contains the addons that can be installed in the cluster.
   • clusters: Contains cluster-specific overrides for the addons.
   • envs: Contains environment-specific overrides for the addons.

3. Once the repository is configured with the required addons, they will be available in the Addons section of your ArgoCD instance.

In the next section, we will see how to install the addons in the cluster.