blumeops/docs/reference/kubernetes/apps.md
Erich Blume 0018d3c593 Add Reference section with 24 technical reference cards
Phase 2 of documentation restructuring. Creates docs/reference/ with:

Services (16):
- alloy, argocd, borgmatic, 1password, forgejo, grafana
- jellyfin, kiwix, loki, miniflux, navidrome, postgresql
- prometheus, teslamate, transmission, zot

Infrastructure (3):
- hosts - Device inventory
- tailscale - ACLs, groups, tags
- routing - DNS domains and port mappings

Kubernetes (2):
- cluster - Minikube specs
- apps - ArgoCD application registry

Storage (2):
- sifaka - Synology NAS configuration
- backups - Backup policy

All cards use wiki-links for cross-referencing and include YAML
frontmatter with title and tags for Quartz.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 13:23:24 -08:00

3 KiB

title tags
ArgoCD Applications
kubernetes
argocd

ArgoCD Applications

Registry of all applications deployed via services/argocd.

Application Registry

App Namespace Path/Source Service
apps argocd argocd/apps/ App-of-apps root
argocd argocd argocd/manifests/argocd/ services/argocd
tailscale-operator tailscale argocd/manifests/tailscale-operator/ Tailscale k8s operator
1password-connect 1password argocd/manifests/1password-connect/ services/1password
external-secrets external-secrets Helm chart services/1password
external-secrets-config external-secrets argocd/manifests/external-secrets-config/ services/1password
cloudnative-pg cnpg-system Helm chart (forge mirror) PostgreSQL operator
blumeops-pg databases argocd/manifests/databases/ services/postgresql
prometheus monitoring argocd/manifests/prometheus/ services/prometheus
loki monitoring argocd/manifests/loki/ services/loki
grafana monitoring Helm chart (forge mirror) services/grafana
grafana-config monitoring argocd/manifests/grafana-config/ services/grafana
alloy-k8s alloy argocd/manifests/alloy-k8s/ services/alloy
kube-state-metrics monitoring argocd/manifests/kube-state-metrics/ K8s metrics
miniflux miniflux argocd/manifests/miniflux/ services/miniflux
kiwix kiwix argocd/manifests/kiwix/ services/kiwix
torrent torrent argocd/manifests/torrent/ services/transmission
navidrome navidrome argocd/manifests/navidrome/ services/navidrome
teslamate teslamate argocd/manifests/teslamate/ services/teslamate
forgejo-runner forgejo-runner argocd/manifests/forgejo-runner/ services/forgejo CI

Sync Policies

Application Policy Rationale
apps Automated Picks up new Application manifests
All others Manual Explicit control over deployments

Common Commands

argocd app list                    # List all apps
argocd app get <app>               # Get details
argocd app diff <app>              # Preview changes
argocd app sync <app>              # Deploy changes

PR Workflow

  1. Create feature branch, modify manifests
  2. Push to forge
  3. Sync apps application: argocd app sync apps
  4. Point service at branch: argocd app set <service> --revision feature/branch
  5. Test: argocd app sync <service>
  6. After merge, reset: argocd app set <service> --revision main