From 36cdd1fc25d5a9002ab387a9778ee8688f5d59c9 Mon Sep 17 00:00:00 2001
From: Simone <simone@emulab.it>
Date: Tue, 12 May 2026 21:57:18 +0200
Subject: [PATCH] docs(burn-in): add README for burnin-dummy repo

---
 gitea/burnin-dummy/README.md | 81 ++++++++++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 gitea/burnin-dummy/README.md

diff --git a/gitea/burnin-dummy/README.md b/gitea/burnin-dummy/README.md
new file mode 100644
index 0000000..0725212
--- /dev/null
+++ b/gitea/burnin-dummy/README.md
@@ -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`