# Local CI/CD System — Design & Status

## Sistema implementato e operativo (2026-05-08)

### Hardware
- Windows 11 host — CPU i9-10900X, 64 GB RAM, NVMe SSD

### Hypervisor
- VMware Workstation Pro
- Template VM: Windows Server 2025
  - VMX: `F:\CI\Templates\WinBuild\CI-WinBuild.vmx`
  - Snapshot: `BaseClean`
  - Toolchain: VS Build Tools 2026 (MSBuild 18.5.4 / v145), .NET SDK 10.0.203, Python 3.13.3

### CI System
- Gitea self-hosted — `http://10.10.20.11:3100`
- act_runner v1.0.2 — Windows service su host, label `windows-build`
- Build VMs: subnet VMnet8 NAT — `192.168.79.0/24`
- WinRM HTTPS/5986 (Basic auth over HTTPS, self-signed cert, SkipCACheck lab-only)

### Architettura implementata
1. Gitea Actions enqueue job → act_runner lo prende
2. `Invoke-CIJob.ps1` orchestra 6 fasi:
   - **Phase 1**: `git clone` repo (con submoduli) su host in `C:\Temp\ci-src-<jobid>`
   - **Phase 2**: `New-BuildVM.ps1` — linked clone da template snapshot `BaseClean`
   - **Phase 3**: `vmrun start` VM headless
   - **Phase 4**: `Wait-VMReady.ps1` — polling WinRM readiness (~5s)
   - **Phase 5**: `Invoke-RemoteBuild.ps1` — trasferisce sorgente (zip), esegue build via WinRM, raccoglie `artifacts.zip`
   - **Phase 6**: `Get-BuildArtifacts.ps1` — copia zip in `F:\CI\Artifacts\<jobid>\`
3. `finally`: `Remove-BuildVM.ps1` — stop VM + rimozione directory clone

### Caso d'uso implementato e testato
- Repo: `Simone/nsis-plugin-nsinnounp` (NSIS plugin C++ — MSBuild)
- Build command: `python build_plugin.py --final --dist-dir dist`
- 4 configurazioni parallele: x86-unicode, x64-unicode, cli-x86, cli-x64
- Artifact: `dist/x86-unicode/nsInnoUnp.dll`, `dist/amd64-unicode/nsInnoUnp.dll`, `dist/nsInnoUnpCLI.exe`, `dist/nsInnoUnpCLI64.exe`
- e2e-009: SUCCESS in 02:09, cleanup automatico confermato

### Fix critici applicati durante sviluppo
- **TRK0002 Windows quota exhaustion**: `build_plugin.py` divide thread count per numero di build parallele
- **MSBuild detection per VS 2026**: fix in `build_plugin.py` per vswhere con VS 2026 BuildTools
- **Output filter nascondeva errori**: filtro cambiato da substring a prefix match
- **--dist-dir**: nuovo flag per raccogliere artifact in cartella piatta pre-clean
- **--no-clean / --no-copy**: flag CI-friendly per skip cleanup e skip copia verso plugins dir