---
title: GitOps Workflow
category: concepts
tags: [gitops, argocd, iac, terraform, ansible, workflow]
created: "2026-07-24"
modified: "2026-07-24"
---

# GitOps Workflow

## Prinzip
Infra-Changes **bevorzugt** über GitOps. Geht nicht immer. Ausnahmen müssen von Dominik freigegeben werden.

## Workflow
1. IaC Repo lokal auschecken (`/root/iac-homelab` auf VM200)
2. Ändern (Tofu/Ansible/K8s Manifeste)
3. Commit + Push (zu BEIDEN Gitea Remotes: origin + k8s)
4. ArgoCD sync (oder auto-sync)
5. Verify (kubectl get, curl, etc.)
6. Lokale Kopie löschen

## ArgoCD
- 15 Applications via SSH Deploy Keys
- `ssh://gitea@git.schoen.codes:22/dominik/iac-homelab.git`
- `--force` kann nicht mit ServerSideApply kombiniert werden
- Bei hängendem Operation-State: App terminieren und neu anstoßen

## IaC Tools
- **OpenTofu**: VM/CT Provisioning, GPU PCI Mapping
- **Ansible**: RKE2 Installation, Node Taints, Fluent Bit
- **K8s Manifeste**: clusters/main/apps/*.yaml

## Was NICHT über GitOps geht
- Direkte DB-Operationen (SQL)
- Ceph `ceph` CLI Befehle
- Proxmox `pct`/`qm` Live-Operationen
- Notfall-Reparaturen

## Related
- [[systems/rke2-kubernetes]]
- [[systems/gitea]]