2.4 KiB
2.4 KiB
pattern_id, title, category, severity, status, first_observed, last_updated, related_systems, related_solution_docs, related_skills
| pattern_id | title | category | severity | status | first_observed | last_updated | related_systems | related_solution_docs | related_skills | |||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| PAT-015 | systemd-PATH-Blindness: binaries aus ~/.local/bin verschwinden im Service-Kontext | infrastructure | high | active | 2026-10 | 2026-10-08 |
|
|
PAT-015 — systemd-PATH-Blindness
Trigger: Ein Skript, das interaktiv/per SSH fehlerfrei läuft, stirbt als systemd-Service mit
command not found (Exit 127) — typischerweise bei pip-user-installierten CLIs (aws, uv),
Node/npm-Tools oder allem unter $HOME/.local/bin, $HOME/.cargo/bin, /opt/*.
Symptom
- Journal:
<script>: line NN: aws: command not found→status=127 - Dieselbe Binary funktioniert problemlos in der interaktiven Shell desselben Users.
- Bei
set -e-Skripten mit Cleanup AM ENDE: sekundär Müll-Akkumulation, weil der Exit vor dem Aufräumschritt liegt.
Root Cause
systemd startet Units mit definiertem Minimal-PATH (/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin),
OHNE die User-Shell-Profile zu sourcen. Pip --user-Installationen landen in ~/.local/bin,
das nur via ~/.profile/shell-Init in PATH kommt. Interaktiv≠Serviceland.
Mitigation
- Robuste Variante (im Skript): Absolutpfad mit Fallback-Kette:
BIN="$(command -v foo || true)"; [ -z "$BIN" ] && BIN="/home/user/.local/bin/foo"; [ -x "$BIN" ] || exit 1 - Unit-seitig: Drop-in
Environment="PATH=/home/user/.local/bin:$PFAD"— macht ALLE Scripts der Unit robust, auch solche Dritter. - Cleanup-Traps:
trap 'rm -f "$TMPFILE"' EXIT— garantiert Aufräumen bei JEDEM Exit, egal woset -ezuschlägt.
Prevention
- Beim Schreiben neuer systemd-Units mit User-Skripten: PATH-Annahme niemals erben lassen.
- Watchdog-Muster: Backup-Jobs brauchen Alter-des-letzten-Erfolgs-Monitoring (still sterbende Jobs bleiben sonst Wochen unsichtbar — hier 10+ Tage TOOT).
- Bei Exit-127 im Journal zuerst PATH-Differenz interaktiv vs. Service prüfen (
systemctl show -p Environment).
Evidence
- 2026-10-08: hermes-backup.service (backup-to-s3.sh, täglich 04:00 UTC) Exit 127 seit ≥27.09., 10× ~2G-Tarballs in /tmp bis Root-FS 100 %. Fix: Skript-AWS_BIN + Drop-in-PATH + trap. Verifikation: Produktionslauf SUCCESS + S3-Readback 2.284.533.218 B. → docs/solutions/bug-fixes/2026-10-08-hermes-offsite-backup-aws-path-rca.md