Files

T

Simone 0d6486b19b chore(plans): archive Phase A and B completed documents

Moves all A/B closeouts, checklists, idea docs, and implementation plans
to plans/archived/2026-05-23/. Both phases are production-stable.

Active plans remaining in plans/:
  - idea-3-powershell-removal.md  (Phase C — in progress)
  - idea-3-esxi-support.md        (Phase D — future)
  - ideas-overview.md             (roadmap reference)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-23 19:52:09 +02:00

4.4 KiB

Raw Permalink Blame History

B5 — Closeout

Passo B5 di plans/PhaseB-user-checklist.md: conversione scheduled task Windows in coppie *.service + *.timer systemd su Linux.

Stato

✅ COMPLETATO — 5 timer attivi, tutti e 5 i service PASS al trigger manuale.

Cosa è stato fatto

Inventario dei 4 task in scripts/Register-CIScheduledTasks.ps1 (cadenze + comandi) + aggiunta ci-backup-template (non era in PS).
Invoke-RetentionPolicy.ps1 portato in Python come sub-comando retention run (src/ci_orchestrator/commands/retention.py).
Backup-CITemplate.ps1 portato in Python come sub-comando template backup (src/ci_orchestrator/commands/template.py) con compressione 7z a -mx=1 -mmt=on → archivi .7z in /var/lib/ci/backups/.

5 coppie *.service + *.timer deployate in /etc/systemd/system/:

Unit	Cadenza	Comando
`ci-cleanup-orphans`	ogni 6h + al boot	`ci_orchestrator vm cleanup --max-age-hours 6`
`ci-retention-policy`	daily 03:00 + 30min jitter	`ci_orchestrator retention run`
`ci-watch-disk-space`	ogni 15min	`ci_orchestrator monitor disk`
`ci-watch-runner-health`	ogni 15min	`ci_orchestrator monitor runner --service-name act-runner`
`ci-backup-template`	domenica 02:00 + 1h jitter	`ci_orchestrator template backup --all-templates`

Prerequisiti creati sull'host prima del deploy:

sudo mkdir -p /var/log/ci /var/lib/ci/backups
sudo chown ci-runner:ci-runner /var/log/ci

systemctl list-timers --all 'ci-*' → 5 timer active. ✅ PASS
Trigger manuale di tutti e 5 i service → ✅ tutti PASS.
deploy/systemd/README.md aggiornato: tabella mapping, prerequisiti, istruzioni install/test/rollback — senza riferimenti a PowerShell.

Deviazioni / gotcha

pwsh non richiesto: Invoke-RetentionPolicy.ps1 e Backup-CITemplate.ps1 sono stati portati integralmente a Python in questa fase, eliminando la dipendenza da PowerShell Core per tutti e 5 i timer. Questo è il primo passo verso la Fase C (plans/idea-3-powershell-removal.md).
--service-name act-runner: il default del comando monitor runner era act_runner (nome Windows). Il service Linux si chiama act-runner (trattino). Il fix è nel parametro ExecStart di ci-watch-runner-health.service.
ci-backup-template gira come root: il backup richiede systemctl stop/start act-runner.service (gestito con try/finally in Python). Gli altri 4 service girano come ci-runner.
Prerequisiti directory: ReadWritePaths in ProtectSystem=strict richiede che le directory esistano prima che la unit venga avviata. ci-watch-runner-health e ci-cleanup-orphans usano /var/log/ci; ci-backup-template usa /var/lib/ci/backups. Entrambe vanno create prima del deploy (vedi sopra).
Bug pre-esistente in vm.py (_list_orphans): is_dir() era chiamato fuori dal blocco try/except OSError, causando un'eccezione su symlink rotti. Corretto spostando is_dir() all'interno del try.

Cadenze systemd (vs Windows originale)

Task	Windows originale	systemd timer
cleanup-orphans	ogni 6h + al boot	`OnBootSec=2min, OnUnitActiveSec=6h, Persistent`
retention-policy	daily 03:00 + 30min delay	`OnCalendar=--* 03:00:00, RandomizedDelaySec=30min`
watch-disk-space	ogni 15min	`OnBootSec=5min, OnUnitActiveSec=15min`
watch-runner-health	ogni 15min	`OnBootSec=3min, OnUnitActiveSec=15min`
backup-template	(non era in PS)	`OnCalendar=Sun --* 02:00:00, RandomizedDelaySec=1h`

Riferimenti commit

43a69b8 — feat: B5 — port retention/template-backup to Python, deploy systemd timers

4.4 KiB Raw Permalink Blame History