Argo CD
Introduction
This document provides step-by-step instructions for integrating your IDP software with ArgoCD. The integration can be achieved through two methods:
Synchronous Method: Fetching data using a service account token.
Asynchronous Method: Receiving data via webhooks.
Ideally for best performance and up to the date information you should have both methods enabled.
Before proceeding, ensure you have the following information:
Plugin Name: A unique identifier for your application.
BaseURL: The public URL of your ArgoCD server.
Account Token: A token with read permissions for ArgoCD.
Webhook Token: A token for receiving live changes via webhooks.
Method 1: Synchronous Data Fetching
Creating a Service Account in ArgoCD
To fetch data synchronously, you need to create a service account in ArgoCD with read permissions.
Steps:
Create a Service Account:
Refer to Creating an Argo CD Service Account for detailed steps.
Additionally, consult the official ArgoCD documentation on Service Account Token Generation.
Set the Token in IDP Software:
After creating the service account and generating the token, enter this token in plugin configuration as the 'Account Token'.
Method 2: Asynchronous Data Fetching via Webhooks
Setting Up Notifications Service in ArgoCD
For asynchronous data fetching, configure the notifications service in ArgoCD.
Requirements:
ArgoCD version 2.10 or later: Use the built-in notifications controller.
Earlier versions of ArgoCD: Install the argocd-notifications helm chart.
Installation:
For ArgoCD 2.10 or later, refer to the Notifications Controller Documentation.
For earlier versions, use the Helm chart available at ArgoCD Notifications Documentation, with the chart details:
Configure
values.yaml