No description
  • Python 97.1%
  • Shell 1.4%
  • Go Template 0.9%
  • Just 0.6%
Find a file
nic.rossmann 6496ccceee
scripts/netbox: NetBox der Staatsoper unter netbox.enter.staatsoper.hamburg
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
2026-11-20 13:18:24 +01:00
files Initiales Repo-Gerüst: Ansible-Struktur, Secrets-Handling, Nix-Dev-Shell 2026-08-31 11:17:16 +02:00
grafana zabbix/grafana: Meldungen bündeln, Schweren angeglichen, Access-Ports still, Silence-Befehl 2026-11-20 12:29:00 +01:00
inventories inventories/inspizienz: Steuerskript Interface_1 nicht überwachen 2026-11-20 13:13:34 +01:00
playbooks zabbix/grafana: Alarm-Rauschen reduziert (Q-SYS-Hysterese, bewusste Zustände) 2026-11-20 12:02:46 +01:00
roles Initiales Repo-Gerüst: Ansible-Struktur, Secrets-Handling, Nix-Dev-Shell 2026-08-31 11:17:16 +02:00
scripts scripts/netbox: NetBox der Staatsoper unter netbox.enter.staatsoper.hamburg 2026-11-20 13:18:24 +01:00
templates Initiales Repo-Gerüst: Ansible-Struktur, Secrets-Handling, Nix-Dev-Shell 2026-08-31 11:17:16 +02:00
zabbix/templates inventories/inspizienz: Desk Mobil XC-7 (Testgerät) nicht überwachen 2026-11-20 13:05:50 +01:00
.ansible-lint zabbix/templates: TrueNAS SCALE by SNMP statt TrueNAS CORE für truenas 2026-10-15 11:38:16 +02:00
.gitignore scripts/netbox: zweite Instanz (NetBox Industrial Arts) über NETBOX_ENV 2026-10-09 12:15:16 +02:00
.sops.yaml Initiales Repo-Gerüst: Ansible-Struktur, Secrets-Handling, Nix-Dev-Shell 2026-08-31 11:17:16 +02:00
.vault-pass.example Initiales Repo-Gerüst: Ansible-Struktur, Secrets-Handling, Nix-Dev-Shell 2026-08-31 11:17:16 +02:00
.yamllint zabbix/templates: TrueNAS SCALE by SNMP statt TrueNAS CORE für truenas 2026-10-15 11:38:16 +02:00
ansible.cfg Dev-Umgebung: Nix durch Fedora-Setup ersetzen 2026-10-05 14:53:45 +02:00
CLAUDE.md zabbix/grafana: Meldungen bündeln, Schweren angeglichen, Access-Ports still, Silence-Befehl 2026-11-20 12:29:00 +01:00
justfile scripts/cbd: API-Zugang zum Cisco Business Dashboard (cbd.py, Vault) 2026-11-06 14:05:50 +01:00
README.md scripts/qsys: qrc-watch.py – Q-SYS-Core per QRC, Dienst auf mon-ia 2026-11-10 11:20:45 +01:00
requirements.yml playbooks: Zabbix-Hauptversion wechseln (mon-ia, Agenten), community.zabbix >= 4.3.0 2026-11-19 14:26:49 +01:00

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

  1. Vault-Passwort anlegen (Datei ist in .gitignore):

    cp .vault-pass.example .vault-pass
    $EDITOR .vault-pass          # echtes Passwort eintragen
    chmod 600 .vault-pass
    

    ansible.cfg liest die Datei über scripts/vault-pass.sh automatisch. 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).

  2. 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.yml
    

    Die verschlüsselte vault.yml beginnt mit $ANSIBLE_VAULT;... und wird committet – der Inhalt ist ohne .vault-pass unlesbar.

  3. Konvention: geheime Variablen mit Präfix vault_ benennen und in vars.yml referenzieren:

    # vars.yml (committet, lesbar)
    db_password: "{{ vault_db_password }}"
    

    So ist dokumentiert, welche Secrets existieren, ohne die Werte zu zeigen.

  4. 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

  1. Das betroffene Geheimnis rotieren (neu setzen) – es gilt als kompromittiert.
  2. History bereinigen (git filter-repo / BFG) und Force-Push abstimmen.

Voraussetzungen

  • Fedora (getestet: 44) mit sudo-Rechten für dnf
  • SSH-Zugang zu den Zielhosts (siehe ansible.cfg)
  • Befehle aus dem Repo-Root ausführen – Ansible liest dann ./ansible.cfg automatisch

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.