docs(burn-in): add README for burnin-dummy repo

2026-05-12 21:57:18 +02:00
parent 9601210baa
commit 36cdd1fc25
1 changed files with 81 additions and 0 deletions
@@ -0,0 +1,81 @@
+# burnin-dummy
+
+Repository di test per il burn-in del sistema CI locale (Local-CI-CD-System).
+
+Non contiene codice reale. Serve a esercitare l'intero pipeline CI senza dipendere
+da una toolchain di build specifica.
+
+---
+
+## Contenuto
+
+| File | Scopo |
+|---|---|
+| `build.ps1` | Fake build: attende ~30s, scrive `dist\build-info.txt` con data/host/PID |
+
+---
+
+## Come si usa
+
+Il repository viene clonato automaticamente da `Invoke-CIJob.ps1` in ogni job di burn-in.
+Non e' necessario eseguire nulla a mano.
+
+### Burn-in senza artifact (smoke rapido)
+
+```powershell
+.\scripts\Start-BurnInTest.ps1 -Rounds 1
+```
+
+`-SkipArtifact` e' attivo per default: il job completa senza raccogliere artifact.
+Usa `-BuildCommand 'ping 127.0.0.1 -n 601 > nul'` per round da ~10 minuti.
+
+### Burn-in con pipeline artifact completa
+
+```powershell
+.\scripts\Start-BurnInTest.ps1 -Rounds 1 -NoSkipArtifact
+```
+
+Richiede che `build.ps1` sia presente nel repo (gia' incluso).
+Il job esegue `build.ps1`, impacchetta `dist\` come `artifacts.zip` e lo copia
+in `F:\CI\Artifacts\<job-id>\`.
+
+### Parametri principali di Start-BurnInTest.ps1
+
+| Parametro | Default | Descrizione |
+|---|---|---|
+| `-Rounds` | 3 | Round sequenziali |
+| `-Parallelism` | 4 | Job concorrenti per round |
+| `-BuildCommand` | `powershell ... build.ps1` | Comando eseguito nel guest |
+| `-NoSkipArtifact` | (assente) | Abilita raccolta artifact |
+| `-RoundTimeoutMinutes` | 60 | Timeout per round |
+
+---
+
+## Struttura artifact prodotti
+
+```
+F:\CI\Artifacts\
+  burnin-r1-j1-<hhmmss>\
+    artifacts.zip          <- dist\build-info.txt compresso
+    invoke-cijob.log
+  burnin-r1-j2-<hhmmss>\
+    ...
+```
+
+`build-info.txt` contiene:
+
+```
+build-ok
+date=2026-05-12 14:32:01
+host=BUILDVM-001
+pid=4812
+```
+
+---
+
+## Prerequisiti (host)
+
+- Credential Manager target `BuildVMGuest` — credenziali administrator del guest Windows
+- Credential Manager target `GiteaPAT` — PAT Gitea con accesso read a questo repo
+- Template `F:\CI\Templates\WinBuild2025\WinBuild2025.vmx` con snapshot `BaseClean`
+- VMware Workstation Pro con VMnet8 NAT `192.168.79.0/24`