2.2 KiB
2.2 KiB
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/<name>.yaml(cnpg,external-secrets,gitea,headlamp,immich,keycloak,metrics-server,nextcloud,openbao), captured spec-for-spec from the cluster. root-app.yamldefines the root Applicationall-apps, which manages everything inapplications/onmain. It is applied manually with noautomated,prune, orselfHeal; edits toapplications/take effect after a manual sync ofall-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; useapplications/instead. keycloakandopenbaowere alreadyOutOfSync/Healthybefore 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/<app>/values.yaml. Edit<app>/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 inapplications/immich.yamlwhile its values source still tracksHEAD. Upgrade steps:gitea/README.md,keycloak/README.md.
Verification
- No build/test/lint/CI config or task runner exists. Useful checks:
kustomize build <app>forimmich/andkeycloak/, andkubectl apply --dry-run=server -f <manifest>. kubectluses contextkubernetes-admin@kubernetes; theargocdCLI is not installed.- Lint changed manifests with
kube-linter lint <file.yaml>; 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 -Awould stagegitea.token,opencode.json,.DS_Store, and the untracked Argo manifests. Stage files explicitly.