ops-agent: baseline = live + operator-run installer #131

Merged
janpeter merged 2 commits from fix/ops-agent-baseline-install into master 2026-10-11 04:37:18 +02:00
Owner

Lost de max2 ops-agent config-drift (2026-10-11) op.

  • Baseline commands.yml opnieuw bevroren op live (2 hunks: media-organizer deploy-wrapper, --retry-all-errors in smoke_ops_dashboard; beide bewuste live-edits van 2026-10-08).
  • Nieuw scripts/install-ops-agent-config.sh: dry-run default; --apply valideert YAML, tarball-snapshot + MANIFEST onder /srv/_attic/<datum>-ops-agent-config/ (mode 600, read-back), behoudt owner/mode, herstart ops-agent bij commands.yml.
  • Runbook §2: repo is bron, live wordt eruit geinstalleerd, geen .bak in /etc/ops-agent.

Getest tegen wegwerp-dirs: dry-run, apply (owner/mode, snapshot), idempotent tweede run, ongeldige YAML schrijft niets (rc 2). Detector na baseline-wijziging: no drift.

Na merge: git pull --ff-only in /srv/scrum4me/repos/scrum4me-docker zodat de detector de nieuwe baseline leest.

🤖 Generated with Claude Code

Lost de max2 ops-agent config-drift (2026-10-11) op. - Baseline `commands.yml` opnieuw bevroren op live (2 hunks: media-organizer deploy-wrapper, `--retry-all-errors` in `smoke_ops_dashboard`; beide bewuste live-edits van 2026-10-08). - Nieuw `scripts/install-ops-agent-config.sh`: dry-run default; `--apply` valideert YAML, tarball-snapshot + MANIFEST onder `/srv/_attic/<datum>-ops-agent-config/` (mode 600, read-back), behoudt owner/mode, herstart ops-agent bij `commands.yml`. - Runbook §2: repo is bron, live wordt eruit geinstalleerd, geen `.bak` in `/etc/ops-agent`. Getest tegen wegwerp-dirs: dry-run, apply (owner/mode, snapshot), idempotent tweede run, ongeldige YAML schrijft niets (rc 2). Detector na baseline-wijziging: `no drift`. Na merge: `git pull --ff-only` in `/srv/scrum4me/repos/scrum4me-docker` zodat de detector de nieuwe baseline leest. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
ops-agent: baseline = live, plus operator-run installer (repo is the source)
All checks were successful
CI / Compose config (pull_request) Successful in 4s
CI / Scanner gelijk aan bron (pull_request) Successful in 3s
CI / Build-arg coverage (pull_request) Successful in 9s
CI / Docker build (pull_request) Successful in 2m31s
76415c0ecf
De live commands.yml week af van de baseline door twee bewuste live-edits van
2026-10-08 (media-organizer deploy-wrapper, --retry-all-errors) die nooit naar
de repo gingen. Baseline opnieuw bevroren op live (2 regels).

Structureel: scripts/install-ops-agent-config.sh installeert de baseline op
/etc/ops-agent (dry-run default; --apply valideert YAML, maakt een tarball-
snapshot met MANIFEST onder /srv/_attic, behoudt owner/mode, herstart ops-agent
bij commands.yml). Runbook §2 herschreven: repo is bron, geen .bak in /etc.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

REQUEST_CHANGES

Geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden.

Findings

  • error (blokkerend) — scripts/install-ops-agent-config.sh:62 — Herhaalde apply herstelt een mislukte herstart niet. commands.yml is al vervangen wanneer systemctl restart ops-agent faalt. Een tweede --apply meldt vervolgens live == baseline; nothing to do en exit 0, zonder herstart. De driftcheck wordt eveneens groen, hoewel de service gestopt kan zijn of de nieuwe allowlist niet succesvol geladen is. Bewaar een pending-restart status of herstel de oude bestanden bij falen, zodat opnieuw uitvoeren ook de activatie afrondt. Voeg een regressietest toe met een falende eerste herstart.
  • error (blokkerend) — scripts/install-ops-agent-config.sh:101 — Ontbrekende live flows/-map veroorzaakt een gedeeltelijke installatie. De invoercontrole accepteert een live hoofdmap zonder flows/. Met een gewijzigde commands.yml en een nieuwe baseline-flow wordt eerst de allowlist vervangen; daarna faalt mktemp "$dest.XXXXXX" wegens de ontbrekende parent directory en wordt de herstart overgeslagen. Maak de benodigde map met passende rechten vóór installatie, of wijs deze toestand vóór de eerste live-write af. Voeg dekking voor dit scenario toe.

Onderbouwing en verificatie

Beoordeeld tegen de productdocs Overview en Agent Guidance, het bestaande drift-script en het host-config-runbook. De operator-run aanpak, beperkte bestandscope en tarball met read-back sluiten aan op de beschreven discipline. De twee baselinewijzigingen passen bij de scope van de PR; de installerfoutpaden verhinderen goedkeuring.

bash -n en git diff --check slagen. npm test: 88 testbestanden geslaagd, 1326 tests geslaagd en 8 overgeslagen. npm run typecheck:dispatch slaagt na initialisatie van het gepinde submodule.

Beide foutpaden gereproduceerd in wegwerpmappen: falende herstart → eerste run exit 1, tweede run exit 0 zonder tweede herstart; ontbrekende flows/ → exit 1 nadat commands.yml al is vervangen. Omdat deze reviewcontainer geen root/sudo en geen PyYAML heeft, gebruikte de reproductie een kopie met uitsluitend de root-guard uitgeschakeld, een YAML-validator via de geïnstalleerde Node YAML-library en een stub voor systemctl. De installatie- en herstartlogica bleef verder ongewijzigd. Geen live hostbestanden gewijzigd.

## REQUEST_CHANGES Geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden. ### Findings - **error (blokkerend)** — scripts/install-ops-agent-config.sh:62 — **Herhaalde apply herstelt een mislukte herstart niet.** `commands.yml` is al vervangen wanneer `systemctl restart ops-agent` faalt. Een tweede `--apply` meldt vervolgens `live == baseline; nothing to do` en exit 0, zonder herstart. De driftcheck wordt eveneens groen, hoewel de service gestopt kan zijn of de nieuwe allowlist niet succesvol geladen is. Bewaar een pending-restart status of herstel de oude bestanden bij falen, zodat opnieuw uitvoeren ook de activatie afrondt. Voeg een regressietest toe met een falende eerste herstart. - **error (blokkerend)** — scripts/install-ops-agent-config.sh:101 — **Ontbrekende live `flows/`-map veroorzaakt een gedeeltelijke installatie.** De invoercontrole accepteert een live hoofdmap zonder `flows/`. Met een gewijzigde `commands.yml` en een nieuwe baseline-flow wordt eerst de allowlist vervangen; daarna faalt `mktemp "$dest.XXXXXX"` wegens de ontbrekende parent directory en wordt de herstart overgeslagen. Maak de benodigde map met passende rechten vóór installatie, of wijs deze toestand vóór de eerste live-write af. Voeg dekking voor dit scenario toe. ### Onderbouwing en verificatie Beoordeeld tegen de productdocs Overview en Agent Guidance, het bestaande drift-script en het host-config-runbook. De operator-run aanpak, beperkte bestandscope en tarball met read-back sluiten aan op de beschreven discipline. De twee baselinewijzigingen passen bij de scope van de PR; de installerfoutpaden verhinderen goedkeuring. `bash -n` en `git diff --check` slagen. `npm test`: 88 testbestanden geslaagd, 1326 tests geslaagd en 8 overgeslagen. `npm run typecheck:dispatch` slaagt na initialisatie van het gepinde submodule. Beide foutpaden gereproduceerd in wegwerpmappen: falende herstart → eerste run exit 1, tweede run exit 0 zonder tweede herstart; ontbrekende `flows/` → exit 1 nadat `commands.yml` al is vervangen. Omdat deze reviewcontainer geen root/sudo en geen PyYAML heeft, gebruikte de reproductie een kopie met uitsluitend de root-guard uitgeschakeld, een YAML-validator via de geïnstalleerde Node YAML-library en een stub voor `systemctl`. De installatie- en herstartlogica bleef verder ongewijzigd. Geen live hostbestanden gewijzigd.
Author
Owner

Beide blokkerende findings opgelost in de nieuwste commit.

  1. Mislukte herstart: vanaf de eerste live-write herstelt iedere falende stap (ook systemctl restart) de originelen uit de snapshot en eindigt de run non-zero; nieuw aangemaakte bestanden worden verwijderd. Een tweede --apply begint dus opnieuw in plaats van "nothing to do". Na de rollback wordt best-effort nog eens herstart met de oude config.
  2. Ontbrekende live flows/: wordt vooraf aangemaakt (eigenaar van de live root, 755); lukt dat niet, dan is er nog niets geschreven.

Regressietests: scripts/test-install-ops-agent-config.sh (stub-systemctl, ALLOW_NONROOT=1, wegwerpmappen): falende herstart + re-run, ontbrekende flows/, ongeldige YAML, dry-run. 7/7 groen. Vereist python3 met PyYAML.

Beide blokkerende findings opgelost in de nieuwste commit. 1. **Mislukte herstart:** vanaf de eerste live-write herstelt iedere falende stap (ook `systemctl restart`) de originelen uit de snapshot en eindigt de run non-zero; nieuw aangemaakte bestanden worden verwijderd. Een tweede `--apply` begint dus opnieuw in plaats van "nothing to do". Na de rollback wordt best-effort nog eens herstart met de oude config. 2. **Ontbrekende live `flows/`:** wordt vooraf aangemaakt (eigenaar van de live root, 755); lukt dat niet, dan is er nog niets geschreven. Regressietests: `scripts/test-install-ops-agent-config.sh` (stub-`systemctl`, `ALLOW_NONROOT=1`, wegwerpmappen): falende herstart + re-run, ontbrekende `flows/`, ongeldige YAML, dry-run. 7/7 groen. Vereist python3 met PyYAML.
install-ops-agent-config: all-or-nothing apply, maak ontbrekende flows/ aan
All checks were successful
CI / Compose config (pull_request) Successful in 4s
CI / Scanner gelijk aan bron (pull_request) Successful in 4s
CI / Build-arg coverage (pull_request) Successful in 9s
CI / Docker build (pull_request) Successful in 6s
196255d84a
Review PR #131: (1) een mislukte `systemctl restart` liet commands.yml al
vervangen, waarna een tweede --apply "nothing to do" meldde. Nu herstelt elke
mislukte stap vanaf de eerste live-write de originelen uit de snapshot en
eindigt non-zero; een re-run begint dus opnieuw. (2) een live root zonder
flows/ gaf een gedeeltelijke installatie; flows/ wordt nu vooraf aangemaakt.
Regressietest: scripts/test-install-ops-agent-config.sh (stub-systemctl).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
janpeter merged commit 463ffca4ce into master 2026-10-11 04:37:18 +02:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/scrum4me-docker!131
No description provided.