docs(readme): sync con stato attuale (Linux support, burn-in, transport, action.yml)

- Stato: aggiornato (Windows+Linux e2e PASS, burn-in 4 job concorrenti PASS)
- Panoramica: diagram aggiornato con Linux/SSH path e dual runner label
- Template VM: aggiunta sezione LinuxBuild2404 (BaseClean-Linux, SSH, ci_build)
- Struttura: aggiunti _Transport.psm1, Test-CapacityBurnIn, Start-BurnInTest-Linux,
  Get-CIJobSummary, template Linux (Deploy/Prepare/Install-CIToolchain), actions/
- Setup rapido: separato in 1a Windows / 1b Linux con Prepare-LinuxBuild2404 -TakeSnapshot
- act_runner: tabella env vars completa (LINUX_TEMPLATE_PATH, SSH_KEY_PATH, ...)
  + labels windows-build:host e linux-build:host
- Uso build manuale: aggiunto esempio Linux guest + note -UseGitClone/-SkipArtifact
- Workflow: composite action documentata con tabella input; matrix Windows+Linux
- Docs: LINUX-TEMPLATE-SETUP.md non piu' 'non implementato'

README.md

@@ -2,7 +2,7 @@
 
 Sistema CI/CD self-hosted su Windows per build isolati in VM efimere VMware.
 
-**Stato**: production-ready — e2e verificato (e2e-009 SUCCESS); §3.3 in-VM git clone attivabile via `-UseGitClone` (e2e PASS, -25.7% vs baseline)
+**Stato**: production-ready — build Windows e Linux verificati e2e; burn-in concorrente a 4 job PASS; §3.3 in-VM git clone attivabile via `-UseGitClone`
 
 ---
 
@@ -15,21 +15,21 @@ Per ogni job, lo script `Invoke-CIJob.ps1` orchestra l'intero ciclo:
 Gitea push/tag
       │
       ▼
-  act_runner  (Windows service, label: windows-build)
+  act_runner  (label: windows-build | linux-build)
       │
       ▼
   Invoke-CIJob.ps1
       │
       ├─ 1. git clone repo su host  (con submoduli)
-      ├─ 2. Linked clone da snapshot BaseClean
+      ├─ 2. Linked clone da snapshot BaseClean / BaseClean-Linux
       ├─ 3. Avvio VM headless
-      ├─ 4. Attesa WinRM ready
+      ├─ 4. Attesa readiness  (WinRM/5986 per Windows, SSH/22 per Linux)
-      ├─ 5. Zip transfer → build via WinRM → raccolta artifacts
+      ├─ 5. Source transfer + build  (WinRM per Windows, SSH/SCP per Linux)
       ├─ 6. Copia artifacts in F:\CI\Artifacts\<jobid>\
       └─ finally: stop + rimozione VM clone
 ```
 
-Ogni build gira in una VM Windows Server 2025 **usa e getta**, ripristinata dallo snapshot `BaseClean` ad ogni run.
+Ogni build gira in una VM **usa e getta** ripristinata dallo snapshot: Windows Server 2025/2022 (WinRM) o Ubuntu 24.04 (SSH).
 
 ---
 
@@ -44,19 +44,32 @@ Ogni build gira in una VM Windows Server 2025 **usa e getta**, ripristinata dall
 | act_runner | v1.0.2 — `F:\CI\act_runner\act_runner.exe` |
 | Gitea | self-hosted `http://10.10.20.11:3100` / `https://gitea.emulab.it` |
 
-## Template VM (snapshot `BaseClean`)
+## Template VM
+
+### Windows (snapshot `BaseClean`)
 
 | Componente | Versione |
 |---|---|
 | OS | Windows Server 2025 |
-| VMX | `F:\CI\Templates\WinBuild2025\WinBuild2025.vmx` (path in `runner/config.yaml` → `GITEA_CI_TEMPLATE_PATH`) |
+| VMX | `F:\CI\Templates\WinBuild2025\WinBuild2025.vmx` (env `GITEA_CI_TEMPLATE_PATH`) |
 | VS Build Tools | 2026 (MSBuild 18.5.4 / toolset v145) |
 | .NET SDK | 10.0.203 |
 | Python | 3.13.3 |
 | Rete | VMnet8 NAT — `192.168.79.0/24` |
 | WinRM | HTTPS/5986, Basic auth, self-signed cert (SkipCACheck — lab-only) |
 
-Variante **Windows Server 2022**: usare i corrispettivi `*WinBuild2022.ps1` e VMX `F:\CI\Templates\WinBuild2022\WinBuild2022.vmx`.
+Variante **Windows Server 2022**: `*WinBuild2022.ps1` + VMX `F:\CI\Templates\WinBuild2022\WinBuild2022.vmx`.
+
+### Linux (snapshot `BaseClean-Linux`)
+
+| Componente | Versione |
+|---|---|
+| OS | Ubuntu 24.04 LTS (cloud image) |
+| VMX | `F:\CI\Templates\LinuxBuild2404\LinuxBuild2404.vmx` (env `GITEA_CI_LINUX_TEMPLATE_PATH`) |
+| Toolchain | GCC, G++, Clang, CMake, Ninja, Python 3, Git, 7-Zip |
+| Rete | VMnet8 NAT — `192.168.79.0/24` |
+| SSH | porta 22, utente `ci_build`, chiave `F:\CI\keys\ci_linux` |
+| Runner label | `linux-build:host` |
 
 ---
 
@@ -67,12 +80,13 @@ Variante **Windows Server 2022**: usare i corrispettivi `*WinBuild2022.ps1` e VM
 ├── PSScriptAnalyzerSettings.psd1 # Regole linting condivise (§5.4)
 │
 ├── scripts/
-│   ├── _Common.psm1              # Shared module (vmrun wrapper, session opts) §5.2
+│   ├── _Common.psm1              # Shared module (vmrun wrapper, diagnostics)
-│   ├── Invoke-CIJob.ps1          # Orchestratore principale (-UseGitClone opt-in §3.3)
+│   ├── _Transport.psm1           # SSH/SCP helpers per guest Linux (Invoke-SshCommand, Copy-SshItem)
+│   ├── Invoke-CIJob.ps1          # Orchestratore principale (Windows WinRM + Linux SSH, -UseGitClone)
 │   ├── New-BuildVM.ps1           # Linked clone da template
-│   ├── Wait-VMReady.ps1          # Polling WinRM HTTPS readiness
+│   ├── Wait-VMReady.ps1          # Polling readiness (WinRM/5986 o SSH/22)
-│   ├── Invoke-RemoteBuild.ps1    # Zip transfer (o git clone in VM) + build via WinRM
+│   ├── Invoke-RemoteBuild.ps1    # Build remoto (WinRM per Windows, SSH/SCP per Linux)
-│   ├── Get-BuildArtifacts.ps1    # Copia artifacts dall'host
+│   ├── Get-BuildArtifacts.ps1    # Raccolta artifacts (WinRM o SCP)
 │   ├── Remove-BuildVM.ps1        # Stop + rimozione VM clone (-WhatIf)
 │   ├── Cleanup-OrphanedBuildVMs.ps1   # Cleanup VM orfane (§2.2)
 │   ├── Invoke-RetentionPolicy.ps1     # Retention artifact + log (§2.3)
@@ -81,7 +95,10 @@ Variante **Windows Server 2022**: usare i corrispettivi `*WinBuild2022.ps1` e VM
 │   ├── Backup-CITemplate.ps1          # Backup VMDK template (§2.6)
 │   ├── Set-TemplateSharedFolders.ps1  # Cache NuGet/pip via shared folders (§3.1)
 │   ├── Measure-CIBenchmark.ps1        # Benchmark fasi pipeline (§3.6)
-│   └── Register-CIScheduledTasks.ps1  # Task Scheduler bootstrap
+│   ├── Register-CIScheduledTasks.ps1  # Task Scheduler bootstrap
+│   ├── Test-CapacityBurnIn.ps1        # Burn-in concorrente N job × R round
+│   ├── Start-BurnInTest-Linux.ps1     # Wrapper burn-in specifico per LinuxBuild2404
+│   └── Get-CIJobSummary.ps1           # Report sintetico ultima esecuzione job
 │
 ├── template/
 │   ├── autounattend.template.xml  # Template XML per installazione Windows unattended
@@ -91,14 +108,19 @@ Variante **Windows Server 2022**: usare i corrispettivi `*WinBuild2022.ps1` e VM
 │   ├── Deploy-WinBuild2022.ps1   # Deploy VM + install Windows 2022 unattended (HOST)
 │   ├── Prepare-WinBuild2022.ps1  # Provisioning toolchain 2022 via WinRM (HOST-side)
 │   ├── Install-CIToolchain-WinBuild2022.ps1    # Toolchain CI 2022 nella VM (GUEST-side)
-│   ├── Validate-DeployState.ps1  # Validazione stato post-Deploy (2025 e 2022)
+│   ├── Deploy-LinuxBuild2404.ps1 # Deploy cloud image Ubuntu 24.04 su VMware (HOST)
+│   ├── Prepare-LinuxBuild2404.ps1# Provisioning toolchain Linux via SSH + snapshot (HOST-side)
+│   ├── Install-CIToolchain-Linux2404.sh        # Toolchain CI Ubuntu 24.04 nel guest (GUEST-side)
+│   ├── Validate-DeployState.ps1  # Validazione stato post-Deploy (2025, 2022, Linux)
 │   └── Validate-SetupState.ps1   # Validazione stato post-Setup (pre-snapshot)
 │
 ├── tests/                        # Pester v5 unit tests (§5.1)
 │
 ├── gitea/
+│   ├── actions/
+│   │   └── local-ci-build/action.yml  # Composite action riusabile (wrap Invoke-CIJob.ps1)
 │   ├── workflows/
-│   │   ├── build-nsis.yml        # Workflow live per nsis-plugin-nsinnounp
+│   │   ├── build-nsis.yml        # Workflow matrix Windows+Linux per nsis-plugin-nsinnounp
 │   │   └── lint.yml              # PSScriptAnalyzer su push/PR (§5.4)
 │   └── workflow-example.yml      # Template generico adattabile
 │
@@ -126,7 +148,7 @@ Variante **Windows Server 2022**: usare i corrispettivi `*WinBuild2022.ps1` e VM
 
 ## Setup rapido
 
-### 1. Template VM
+### 1a. Template VM Windows
 
 **Opzione A — Deploy automatico** (crea VM + installa Windows unattended da ISO):
 
@@ -154,6 +176,25 @@ cd N:\Code\Workspace\Local-CI-CD-System\template
 
 Poi spegni la VM e prendi lo snapshot con nome esatto **`BaseClean`**.
 
+### 1b. Template VM Linux
+
+```powershell
+cd N:\Code\Workspace\Local-CI-CD-System\template
+# Deploy cloud image Ubuntu 24.04 (scarica ISO/cloud img, crea VM):
+.\Deploy-LinuxBuild2404.ps1 -VMPath F:\CI\Templates\LinuxBuild2404\LinuxBuild2404.vmx
+```
+
+**Provisioning toolchain** (SSH — la VM deve essere avviata e raggiungibile):
+
+```powershell
+.\Prepare-LinuxBuild2404.ps1 -VMIPAddress 192.168.79.x `
+    -VMXPath F:\CI\Templates\LinuxBuild2404\LinuxBuild2404.vmx `
+    -TakeSnapshot
+```
+
+`-TakeSnapshot` esegue automaticamente: reset machine-id → shutdown → snapshot **`BaseClean-Linux`**.
+Dettagli: [docs/LINUX-TEMPLATE-SETUP.md](docs/LINUX-TEMPLATE-SETUP.md).
+
 ### 2. Credenziali guest
 
 ```powershell
@@ -174,8 +215,18 @@ nssm install act_runner "F:\CI\act_runner\act_runner.exe" daemon
 nssm start act_runner
 ```
 
-Imposta `GITEA_CI_TEMPLATE_PATH` nelle variabili d'ambiente del servizio:
+Imposta queste variabili d'ambiente nel servizio (`runner/config.yaml`):
-`F:\CI\Templates\WinBuild2025\WinBuild2025.vmx`
+
+| Variabile | Valore |
+|---|---|
+| `GITEA_CI_TEMPLATE_PATH` | `F:\CI\Templates\WinBuild2025\WinBuild2025.vmx` |
+| `GITEA_CI_LINUX_TEMPLATE_PATH` | `F:\CI\Templates\LinuxBuild2404\LinuxBuild2404.vmx` |
+| `GITEA_CI_CLONE_BASE_DIR` | `F:\CI\BuildVMs` |
+| `GITEA_CI_ARTIFACT_DIR` | `F:\CI\Artifacts` |
+| `GITEA_CI_GUEST_CRED_TARGET` | `BuildVMGuest` |
+| `GITEA_CI_SSH_KEY_PATH` | `F:\CI\keys\ci_linux` |
+
+Labels runner: `windows-build:host` (job Windows) e `linux-build:host` (job Linux).
 
 Dettagli completi: [docs/HOST-SETUP.md](docs/HOST-SETUP.md).
 
@@ -188,12 +239,13 @@ Vedi [docs/Setup-GiteaSSH.md](docs/Setup-GiteaSSH.md) per configurare l'alias `g
 
 ## Uso — build manuale (test)
 
+**Windows guest:**
+
 ```powershell
 & 'N:\Code\Workspace\Local-CI-CD-System\scripts\Invoke-CIJob.ps1' `
-  -JobId               'test-001' `
+  -JobId               'test-win-001' `
   -RepoUrl             'ssh://gitea-ci/Simone/nsis-plugin-nsinnounp.git' `
   -Branch              'main' `
-  -Commit              '' `
   -TemplatePath        'F:\CI\Templates\WinBuild2025\WinBuild2025.vmx' `
   -Submodules `
   -BuildCommand        'python build_plugin.py --final --dist-dir dist' `
@@ -201,9 +253,24 @@ Vedi [docs/Setup-GiteaSSH.md](docs/Setup-GiteaSSH.md) per configurare l'alias `g
   -GuestCredentialTarget 'BuildVMGuest'
 ```
 
-Artifacts raccolti in: `F:\CI\Artifacts\test-001\artifacts.zip`.
+**Linux guest:**
 
-Aggiungi `-UseGitClone` per clonare direttamente in VM (skip host-zip-transfer; richiede Git+7-Zip in template — già inclusi nel Tier-1 Toolchain §6.6).
+```powershell
+& 'N:\Code\Workspace\Local-CI-CD-System\scripts\Invoke-CIJob.ps1' `
+  -JobId               'test-linux-001' `
+  -RepoUrl             'ssh://gitea-ci/Simone/nsis-plugin-nsinnounp.git' `
+  -Branch              'main' `
+  -TemplatePath        'F:\CI\Templates\LinuxBuild2404\LinuxBuild2404.vmx' `
+  -SnapshotName        'BaseClean-Linux' `
+  -GuestOS             'Linux' `
+  -BuildCommand        'bash build.sh' `
+  -GuestArtifactSource '/opt/ci/output'
+```
+
+Artifacts raccolti in: `F:\CI\Artifacts\<jobid>\`.
+
+Aggiungi `-UseGitClone` per clonare direttamente in VM (skip host-zip-transfer; richiede Git in template — già incluso nel toolchain).
+Aggiungi `-SkipArtifact` per job che non producono output (es. lint, test puri).
 
 ---
 
@@ -211,9 +278,22 @@ Aggiungi `-UseGitClone` per clonare direttamente in VM (skip host-zip-transfer;
 
 Il file [gitea/workflows/build-nsis.yml](gitea/workflows/build-nsis.yml) è il workflow
 attivo per `Simone/nsis-plugin-nsinnounp`. Si attiva su push di tag `v*` o manualmente.
+Usa una **strategy matrix** `[windows, linux]` che esegue in parallelo su entrambi i runner.
 
-Per adattarlo ad altri repository, copia [gitea/workflow-example.yml](gitea/workflow-example.yml)
+La composite action [gitea/actions/local-ci-build/action.yml](gitea/actions/local-ci-build/action.yml)
-e aggiorna `-RepoUrl`, `-BuildCommand` e `-GuestArtifactSource`.
+asconde tutta la logica Invoke-CIJob.ps1 e accetta questi input principali:
+
+| Input | Descrizione |
+|---|---|
+| `build-command` | Comando di build da eseguire nel guest |
+| `guest-os` | `Windows` (default) o `Linux` |
+| `artifact-source` | Path artifacts nel guest |
+| `skip-artifact` | `true` per job senza output |
+| `repo-url` | URL SSH del repository |
+| `job-id-suffix` | Suffisso per disambiguare artifact dir in matrix |
+
+Per adattare ad altri repository, copia [gitea/workflow-example.yml](gitea/workflow-example.yml)
+e aggiorna `build-command`, `artifact-source`, `repo-url`.
 
 ---
 
@@ -225,7 +305,7 @@ e aggiorna `-RepoUrl`, `-BuildCommand` e `-GuestArtifactSource`.
 | [docs/CI-FLOW.md](docs/CI-FLOW.md) | Descrizione dettagliata di ogni fase del pipeline |
 | [docs/HOST-SETUP.md](docs/HOST-SETUP.md) | Bootstrap macchina host (Setup-Host.ps1) |
 | [docs/WINDOWS-TEMPLATE-SETUP.md](docs/WINDOWS-TEMPLATE-SETUP.md) | Provisioning template Windows (Deploy + Prepare + Setup) |
-| [docs/LINUX-TEMPLATE-SETUP.md](docs/LINUX-TEMPLATE-SETUP.md) | Bozza template Linux (§6.1, non implementato) |
+| [docs/LINUX-TEMPLATE-SETUP.md](docs/LINUX-TEMPLATE-SETUP.md) | Template Ubuntu 24.04: Deploy-LinuxBuild2404, Prepare-LinuxBuild2404, snapshot BaseClean-Linux |
 | [docs/OPTIMIZATION.md](docs/OPTIMIZATION.md) | Layout NVMe, snapshot strategy, cache, tuning |
 | [docs/BEST-PRACTICES.md](docs/BEST-PRACTICES.md) | Sicurezza WinRM, threat model, credenziali |
 | [docs/RUNBOOK.md](docs/RUNBOOK.md) | Triage incident comuni (runner offline, clone fail, ecc.) |