- Python 97.1%
- Shell 1.4%
- Go Template 0.9%
- Just 0.6%
netbox.staatsoper.hamburg ist nicht mehr erreichbar. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01L27nk7W8gjtJ4WMu3eoYHQ |
||
|---|---|---|
| files | ||
| grafana | ||
| inventories | ||
| playbooks | ||
| roles | ||
| scripts | ||
| templates | ||
| zabbix/templates | ||
| .ansible-lint | ||
| .gitignore | ||
| .sops.yaml | ||
| .vault-pass.example | ||
| .yamllint | ||
| ansible.cfg | ||
| CLAUDE.md | ||
| justfile | ||
| README.md | ||
| requirements.yml | ||
ansible-scripts
Zentrales Repository für Ansible Playbooks, Inventories und Scripts.
Zielplattform ist Fedora (getestet: Fedora 44). Alle Werkzeuge installiert
scripts/setup-fedora.sh (dnf + pipx).
Schnellstart
# Werkzeuge installieren (einmalig, braucht sudo)
scripts/setup-fedora.sh # oder: just setup
# Galaxy-Abhängigkeiten holen
just deps
# Linten und Syntax prüfen
just lint
just check staging
# Dry-run bzw. Ausführung
just diff staging
just run staging
Ohne just gehen alle Befehle auch direkt, z. B.:
ansible-playbook -i inventories/production/hosts.yml playbooks/site.yml
Verzeichnisstruktur
.
├── ansible.cfg # Ansible-Konfiguration (inventory, roles_path, ssh, vault)
├── requirements.yml # externe Collections/Rollen (Ansible Galaxy)
├── justfile # Kurzbefehle (just deps | lint | run | …)
│
├── inventories/ # eine Umgebung = ein Unterordner
│ ├── production/
│ │ ├── hosts.yml # Host-/Gruppendefinition
│ │ ├── group_vars/
│ │ │ └── all/
│ │ │ ├── vars.yml # NICHT-geheime Variablen (committet)
│ │ │ ├── vault.yml # geheime Variablen, ansible-vault-verschlüsselt (committet)
│ │ │ └── vault.yml.example # Vorlage (committet)
│ │ └── host_vars/ # host-spezifische Variablen
│ └── staging/ # gleiche Struktur
│
├── playbooks/ # Playbooks; Einstieg: site.yml
├── roles/ # selbst entwickelte Rollen (committet)
├── .galaxy/ # von Galaxy installierte Rollen/Collections (gitignored)
├── scripts/ # Hilfs-Scripts (setup-fedora.sh, vault-pass.sh, check-secrets.sh, …)
│ ├── inspizienz/ # Inspizientenanlage: ptp-watch.py (PTP-Mitschnitt), ptp-announce-watch.py (Announce-Wächter auf mon-ia), geraeteliste.py, nmap-abgleich.py
│ ├── network/ # Beleuchtung/Video: geraeteliste.py
│ ├── qsys/ # qrc-watch.py (Q-SYS per QRC, Dienst auf mon-ia)
│ ├── grafana/ # dashboards.py, alerting.py (push/pull); Zugangsdaten in vault.yml
│ ├── authentik/ # authentik.py (API lesen, schreiben nur mit --apply); Zugang in vault.yml
│ ├── cbd/ # cbd.py (Cisco Business Dashboard, schreiben nur mit --apply); Zugang in vault.yml
│ ├── linkwarden/ # Weboberflächen der Geräteliste -> Linkwarden-Lesezeichen; Zugang in vault.yml
│ └── netbox/ # NetBox-Auswertungen; Zugangsdaten in vault.yml (Ansible-Vault)
├── grafana/dashboards/<Ordner>/ # Grafana-Dashboards als JSON (Unterordner = Grafana-Ordner)
├── grafana/alerting/ # Alerting: Vorlagen, Kontaktpunkte, Richtlinien, regeln/<Ordner>/
├── files/ # statische Dateien für copy-Tasks
└── templates/ # Jinja2-Templates
Weitere Umgebungen werden als zusätzliche Ordner unter inventories/ angelegt
(z. B. inventories/lab/).
Secrets – so werden sie gehandhabt, ohne sie zu committen
Grundregel: Klartext-Geheimnisse landen nie im Git. Committet wird nur, was verschlüsselt oder eine Vorlage ist. Der pre-commit-Hook erzwingt das.
Standard: ansible-vault
-
Vault-Passwort anlegen (Datei ist in
.gitignore):cp .vault-pass.example .vault-pass $EDITOR .vault-pass # echtes Passwort eintragen chmod 600 .vault-passansible.cfgliest die Datei überscripts/vault-pass.shautomatisch. Fehlt sie, laufen Playbooks trotzdem; verschlüsselte Dateien lassen sich dann nur mit--ask-vault-passöffnen. Das Passwort selbst wird über einen sicheren Kanal geteilt (Passwort-Manager, nicht per Chat/Mail). -
Secret-Datei erzeugen und verschlüsseln:
cd inventories/production/group_vars/all cp vault.yml.example vault.yml $EDITOR vault.yml ansible-vault encrypt vault.ymlDie verschlüsselte
vault.ymlbeginnt mit$ANSIBLE_VAULT;...und wird committet – der Inhalt ist ohne.vault-passunlesbar. -
Konvention: geheime Variablen mit Präfix
vault_benennen und invars.ymlreferenzieren:# vars.yml (committet, lesbar) db_password: "{{ vault_db_password }}"So ist dokumentiert, welche Secrets existieren, ohne die Werte zu zeigen.
-
Bearbeiten / Ansehen später:
ansible-vault edit inventories/production/group_vars/all/vault.yml ansible-vault view inventories/production/group_vars/all/vault.yml just vault-edit inventories/production/group_vars/all/vault.yml
Einzelne Werte statt ganzer Dateien gehen auch:
ansible-vault encrypt_string 's3cr3t' --name 'vault_api_token'
Alternative: SOPS + age
Für granulare Verschlüsselung (Werte statt ganzer Datei) und Git-freundliche
Diffs liegt .sops.yaml bei. sops ist nicht in den Fedora-Repos – das RPM
von https://github.com/getsops/sops/releases installieren (age kommt über
scripts/setup-fedora.sh). Kurz:
mkdir -p .sops && age-keygen -o .sops/age.key # .sops/ ist gitignored
age-keygen -y .sops/age.key # public key -> in .sops.yaml eintragen
sops -e -i inventories/production/group_vars/all/vault.sops.yml
Vor der Nutzung export SOPS_AGE_KEY_FILE="$PWD/.sops/age.key" setzen.
Zur Nutzung in Ansible die Collection community.sops in requirements.yml
aufnehmen.
Schutz gegen versehentliches Committen
just install-hooks # pre-commit-Hook: scripts/check-secrets.sh
just secrets-check # ganzes Repo prüfen
Der Hook blockiert jeden Commit, bei dem eine Datei mit vault/secret im
Namen unverschlüsselt ist. Zusätzlich fängt .gitignore Dateien wie
.vault-pass, *.pem, .sops/, secrets.yml ab.
Was tun, wenn doch mal ein Secret committet wurde
- Das betroffene Geheimnis rotieren (neu setzen) – es gilt als kompromittiert.
- History bereinigen (
git filter-repo/ BFG) und Force-Push abstimmen.
Voraussetzungen
- Fedora (getestet: 44) mit
sudo-Rechten fürdnf - SSH-Zugang zu den Zielhosts (siehe
ansible.cfg) - Befehle aus dem Repo-Root ausführen – Ansible liest dann
./ansible.cfgautomatisch
Installierte Tools (scripts/setup-fedora.sh)
Per dnf: ansible-core, python3-ansible-pylibssh, yamllint, python3-passlib,
python3-netaddr, python3-httpx,
sshpass, openssh-clients, age, gnupg2, jq, yq (Go-Version), just,
git, pipx. Per pipx: ansible-lint. Optional von Hand: sops.