argocd.md

ArgoCD

ArgoCD Argo CD is a declarative, GitOps continuous delivery tool for Kubernetes.

Application definitions, configurations, and environments should be declarative and version controlled. Application deployment and lifecycle management should be automated, auditable, and easy to understand.

Usage

ArgoCD can be deployed by enabling the add-on via the following.

#---------------------------------------
# ENABLE ARGOCD
#---------------------------------------
argocd_enable = true

You can optionally customize the Helm chart that deploys ArgoCD via the following configuration.

argocd_helm_chart = {
  name             = "argo-cd"
  chart            = "argo-cd"
  repository       = "https://argoproj.github.io/argo-helm"
  version          = "3.26.3"
  namespace        = "argocd"
  timeout          = "1200"
  create_namespace = true
  values = [templatefile("${path.module}/argocd-values.yaml", {})]
}

Boostrapping

The framework provides an approach to bootstraping workloads and/or additional add-ons by leveraging the ArgoCD App of Apps pattern.

The following code example demonstrates how you can supply information for a repository in order to bootstrap multiple workloads in a new EKS cluster. The example leverages a sample App of Apps repository that ships with the EKS SSP solution.

argocd_applications = {
  workloads = {
    namespace         = "argocd"
    repo_path         = "envs/dev"
    repo_url          = "https://github.com/aws-samples/ssp-eks-workloads.git"
    target_revision   = "HEAD"
    destination       = "https://kubernetes.default.svc"
    project           = "default"
    values            = {}
  }
}

Add-ons

A common operational pattern is to leverage Infrastructure as Code for provisioning EKS clusters (in addition to other AWS resources) and GitOps for managing cluster configuration. The framework provides support for this approach by leveraging the ArgoCD App of Apps pattern.

To configure the framework to leverage ArgoCD for managing add-ons, you must pass configuration for a root ArgoCD Application that points to your desired add-ons. You can specify the root application by setting the add_on_application value to true in your application configuration.

Additionally, you must set the argocd_manage_add_ons property to true. When this flag is set, the framework will still provision all AWS resources necessary to support add-on functionality, but it will not apply Helm charts directly via Terraform. Instead, the framework will pass AWS resource values needed for each add-on to ArgoCD via the values map of the root add-on Application. For specific values passed for each add-on, see the individual add-on documentation.

Sample configuration can be found below:

argocd_enable           = true
argocd_manage_add_ons   = true
argocd_applications     = {
  infra = {
    namespace             = "argocd"
    path                  = "<path>"
    repo_url              = "<repo_url>"
    target_revision       = "HEAD"
    destination           = "https://kubernetes.default.svc"
    project               = "default"
    values                = {}
    add_on_application    = true # Indicates the root add-on application. 
  }
}