Files
management/docs/issues/0083-gitops-50-monitoring-deploy-geaenderte-configs-greifen.md
Thore CimbalandClaude Opus 5 a1def8666e feat(issues): adopt the component trackers — one backlog, one numbering (ADR-0019)
ADR-0012 made docs/issues/ canonical for the management scope only and left
gitops, ThreadNet-Web and threadnet-call on GitLab "until the component adopts".
That split produced exactly what it invited: two numbering worlds where
management#20 and gitops#20 are different issues, drift nobody had to answer for
(gitops#61 carried no milestone since 2026-08-11), and component backlogs that
host sessions without lab access cannot read at all.

The 46 open component issues are now files 0056-0101. The file id is the
group-wide identifier; provenance lives in the frontmatter (new field `projekt`
plus gitlab_iid) and in the filename, so "gitops#61" still finds 0091. Bodies are
copied verbatim; comments and history stay on GitLab, as with the 2026-08-11
management import.

Both scripts learned the second dimension: spiegel_issues.py routes each file to
its origin project, reopens issues that are open in the repo but closed on the
board, and writes the new iid back after creating one; gruppenpruefung.py checks
drift across all four trackers instead of management alone. What the mirror
cannot decide stays a finding, not a silent state.

Two things needed a hand, both recorded in the files: gitops#61 had no milestone
(M1 - it is a live account-takeover path) and carried two area labels where the
schema holds one. The Gitea migration footers in the imported bodies point at
decommissioned trackers; their links are removed, the provenance sentence stays.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 12:00:00 +00:00

2.6 KiB

type, id, status, created, milestone, priority, projekt, gitlab_iid, related
type id status created milestone priority projekt gitlab_iid related
issue 0083 open 2026-08-01 M1 medium gitops 50

Monitoring-Deploy: geaenderte Configs greifen nicht ohne --force-recreate (Inode-Falle bei Einzeldatei-Mounts)

Adoptiert aus gitops#50 (2026-08-18, ADR-0019). Kommentare und Verlauf bleiben dort; kanonisch ist ab jetzt diese Datei.

Beim Deploy von #47 aufgefallen, betrifft aber jede Config-Aenderung am Monitoring-Stack.

Symptom

cd /opt/threadnet-operating && git pull && cd monitoring && docker compose up -d aktiviert geaenderte Config-Dateien nicht. Nach dem Deploy von #47 liefen Scanner und Exporter, aber Prometheus hatte weder den neuen Scrape-Job cve_exporter noch die axion-cve-Regelgruppe geladen -- promtool fand 9 Regeln in der Datei, Prometheus kannte 6.

Ursache

prometheus.yml, alerts.yml und alertmanager.yml sind als einzelne Dateien gemountet. Docker haengt so einen Bind-Mount am Inode auf. git pull schreibt eine neue Datei und benennt sie um -- neuer Inode. Der Container zeigt weiter auf die alte Datei.

Zwei Effekte, die es schwer sichtbar machen:

  • docker compose up -d startet die Container nicht neu, weil die Service-Definition unveraendert ist. Es meldet Running und sieht erfolgreich aus.
  • Ein SIGHUP-Reload laedt brav neu -- nur eben den alten Inhalt. Kein Fehler im Log.

Auf der Platte steht also die neue Config, im Container die alte, und nichts meldet einen Fehler.

Nachweis

$ grep -c axion-cve monitoring/prometheus/alerts.yml            # 1
$ docker exec prometheus grep -c axion-cve /etc/prometheus/alerts.yml   # 0

Abhilfe

Nach jedem git pull, der eine dieser Dateien anfasst:

docker compose up -d --force-recreate prometheus alertmanager

Verifikation muss im Container stattfinden, ein Blick auf die Platte beweist nichts.

Nicht betroffen

Verzeichnis-Mounts (grafana/provisioning/, grafana/dashboards/) loesen ueber den Pfad auf und ziehen Aenderungen mit. Grafana liest Provider-Definitionen aber nur beim Start -- ein neuer Dashboard-Ordner braucht docker compose restart grafana. Dashboard-JSONs innerhalb eines bestehenden Providers werden laufend nachgezogen.

Moegliche Dauerloesung

Statt Einzeldateien die Verzeichnisse mounten (./prometheus:/etc/prometheus:ro), dann verschwindet die Inode-Falle. Dokumentiert ist der Fallstrick vorerst in monitoring/README.md (Commit 2b715ca).


Migriert aus Gitea sorb/axion1337.chat-gitops#52 — dort erstellt am 2026-08-01 von sorb.