Argo CD local setup

Prerequisites

• Docker
• kind
• kubectl
• Argo CD CLI

Steps

Setup Kubernetes cluster

Use single node cluster unless requiring other deployment strategy (e.g., rolling updates)

kind create cluster --config cluster.yaml

Install Argo CD

Steps below are based on ArgoCD's Getting Started

kubectl create namespace argocd

# use the manifest with UI included
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

# for accessing the admin UI
kubectl port-forward -n argocd svc/argocd-server 8080:443

# for https://localhost:8080/
argocd admin initial-password -n argocd

Create an application on Argo CD

Follow step 6 or use application from another repository

NB: It's recommended to separate config and source code repositories.

Deploy an application on Argo CD

Follow step 7

Others

No Docker Desktop (macOS)

Requires Lima

limactl start --name=lima-default template://docker

docker context create lima-default \
  --docker "host=unix://$HOME/.lima/docker/sock/docker.sock"

docker context use lima-default

TODO?

• support Kubernetes version in clsuter configuration
• introduce Makefile to simplify the steps