From 5bd639fdc39e977c1612f308bc5826a28af6cb30 Mon Sep 17 00:00:00 2001 From: obot Date: Sat, 21 Nov 2026 21:53:07 -0500 Subject: [PATCH] Update repo model for app-of-apps adoption --- AGENTS.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8091d4c --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,20 @@ +# Repository guidance + +## Repo model +- GitOps source of truth for one Kubernetes cluster: Argo CD Applications, Helm values, and Kustomize manifests. No application code. +- One directory per app: `gitea/`, `headlamp/`, `immich/`, `keycloak/`, `metrics-server/`. +- All nine live Argo CD Applications are declared in `applications/.yaml` (`cnpg`, `external-secrets`, `gitea`, `headlamp`, `immich`, `keycloak`, `metrics-server`, `nextcloud`, `openbao`), captured spec-for-spec from the cluster. +- `root-app.yaml` defines the root Application `all-apps`, which manages everything in `applications/` on `main`. It is applied manually with no `automated`, `prune`, or `selfHeal`; edits to `applications/` take effect after a manual sync of `all-apps`. +- The older untracked Argo manifests in the working tree (`gitea/app.yaml`, `immich/proj.yaml`, `immich/repo.yaml`) are stale and must not be imported; use `applications/` instead. +- `keycloak` and `openbao` were already `OutOfSync/Healthy` before adoption; treat that as the baseline, not a migration regression. +- Charts come from remote/OCI repos; values live here and are wired via multi-source Argo apps with `$values//values.yaml`. Edit `/values.yaml`, not chart sources; changes take effect on Argo sync. +- gitea chart version is pinned in its Argo app; keycloak is pinned via the remote base ref in `keycloak/kustomization.yaml`; immich's Helm chart is pinned in `applications/immich.yaml` while its values source still tracks `HEAD`. Upgrade steps: `gitea/README.md`, `keycloak/README.md`. + +## Verification +- No build/test/lint/CI config or task runner exists. Useful checks: `kustomize build ` for `immich/` and `keycloak/`, and `kubectl apply --dry-run=server -f `. +- `kubectl` uses context `kubernetes-admin@kubernetes`; the `argocd` CLI is not installed. +- Lint changed manifests with `kube-linter lint `; pass explicit file paths (pointing it at a directory reports "no valid objects found"). + +## Code changes +- Create pull requests at https://gitea.grxe.io/ ; never commit or print it. Only use the stored credentials. +- There is no `.gitignore`: `git add -A` would stage `gitea.token`, `opencode.json`, `.DS_Store`, and the untracked Argo manifests. Stage files explicitly. -- 2.54.0