From bcf3d992a52d3f7c269a252148b0bfc9000cbb0a Mon Sep 17 00:00:00 2001
From: Simon Cornet <simon@simoncor.net>
Date: Wed, 28 Jan 2026 09:57:40 +0100
Subject: [PATCH] feat: add argocd documentation

---
 docs/argocd/argocd.md | 80 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 docs/argocd/argocd.md

diff --git a/docs/argocd/argocd.md b/docs/argocd/argocd.md
new file mode 100644
index 0000000..d61b672
--- /dev/null
+++ b/docs/argocd/argocd.md
@@ -0,0 +1,80 @@
+# ArgoCD
+
+## Install ArgoCD
+
+```bash
+kubectl create namespace argocd
+kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
+```
+
+## Get initial admin password
+
+```bash
+kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d
+```
+
+## Boostrap the ArgoCD configuration using a Git repository
+
+The manifests for the ArgoCD configuration are stored in a git repository. The repository in this example is located at
+`https://gitlab.simoncor.net/kaas/argocd.git` and the path within the repository is `argocd/`.
+
+In this subfolder we have an ArgoCD Application manifest which bootstraps the ArgoCD configuration.
+We also have other manifests for configuring ArgoCD ingress configuration and applications.
+
+```bash
+kubectl apply -f - <<EOF
+---
+apiVersion: "argoproj.io/v1alpha1"
+kind: "Application"
+metadata:
+  name: "argocd"
+  namespace: "argocd"
+spec:
+  project: "default"
+  source:
+    repoURL: "https://gitlab.simoncor.net/kaas/argocd.git"
+    path: "argocd/"
+    targetRevision: "main"
+    directory:
+      recurse: true
+      jsonnet: {}
+  destination:
+    server: "https://kubernetes.default.svc"
+    namespace: "argocd"
+  syncPolicy:
+    automated:
+      prune: true
+      selfHeal: true
+    syncOptions:
+      - "CreateNamespace=true"
+EOF
+```
+
+## ArgoCD Applications
+
+This is an example of an ArgoCD Application manifest which deploys this MkDocs application.
+
+```yam
+---
+apiVersion: "argoproj.io/v1alpha1"
+kind: "Application"
+metadata:
+  name: "docs-simoncor-net"
+  namespace: "argocd"
+spec:
+  project: "default"
+  source:
+    repoURL: "https://gitlab.simoncor.net/kaas/docs-simoncor-net.git"
+    path: "manifests/"
+    targetRevision: "main"
+  destination:
+    server: "https://kubernetes.default.svc"
+    namespace: "docs-simoncor-net"
+  syncPolicy:
+    automated:
+      prune: true
+      selfHeal: true
+      enabled: true
+    syncOptions:
+      - "CreateNamespace=true"
+```