refactor(§7.5): rinomina Setup-* Install-CIToolchain-* (WinBuild2025/2022/Linux2404)

- template/Setup-WinBuild2025.ps1 Install-CIToolchain-WinBuild2025.ps1 - template/Setup-WinBuild2022.ps1 Install-CIToolchain-WinBuild2022.ps1 - template/Setup-LinuxBuild2404.sh Install-CIToolchain-Linux2404.sh Aggiornati tutti i riferimenti in: Prepare-WinBuild2025/2022, Prepare-LinuxBuild2404, Deploy-WinBuild2025/2022/LinuxBuild2404, Validate-DeployState, Validate-SetupState, README.md, TODO.md, docs/WINDOWS-TEMPLATE-SETUP.md, docs/LINUX-TEMPLATE-SETUP.md, docs/TEST-PLAN-v1.3-to-HEAD.md, gitea/actions/local-ci-build/action.yml. §7 chiuso (5/5 done).
2026-05-11 22:48:33 +02:00
parent 6511d47a9a
commit 4758fbc519
17 changed files with 158 additions and 134 deletions
@@ -1,4 +1,4 @@
-# Windows Template VM Setup
+# Windows Template VM Setup

 Procedura di provisioning della template VM **Windows Server 2025** che alimenta i linked
 clone usati per ogni job CI. Il template viene creato **una volta**; lo snapshot
@@ -15,18 +15,18 @@ credenziali archiviate, ISO Windows Server presente).
 | ----------------------------------- | ------------- | -------------------------------------------------------------------- |
 | `template/Deploy-WinBuild2025.ps1`  | **Host**      | Opzionale: crea VM e installa Windows Server 2025 unattended da ISO  |
 | `template/Prepare-WinBuild2025.ps1` | **Host**      | Orchestratore: copia + esegue Setup nel guest via WinRM (2025)       |
-| `template/Setup-WinBuild2025.ps1`   | **Dentro VM** | CI toolchain (user, .NET, Python, VS) + validazione hardening Deploy |
+| `template/Install-CIToolchain-WinBuild2025.ps1`   | **Dentro VM** | CI toolchain (user, .NET, Python, VS) + validazione hardening Deploy |
 | `template/Deploy-WinBuild2022.ps1`  | **Host**      | Opzionale: crea VM e installa Windows Server 2022 unattended da ISO  |
 | `template/Prepare-WinBuild2022.ps1` | **Host**      | Orchestratore: copia + esegue Setup nel guest via WinRM (2022)       |
-| `template/Setup-WinBuild2022.ps1`   | **Dentro VM** | CI toolchain per Windows Server 2022 (stesso flusso del 2025)        |
+| `template/Install-CIToolchain-WinBuild2022.ps1`   | **Dentro VM** | CI toolchain per Windows Server 2022 (stesso flusso del 2025)        |
 | `template/Validate-DeployState.ps1` | **Host**      | Valida stato post-Deploy prima di eseguire Prepare (2025 e 2022)     |
 | `template/Validate-SetupState.ps1`  | **Host**      | Valida stato post-Setup (Deploy + Setup) prima dello snapshot        |

 **Confine Deploy / Setup** (refactor §7, 2026-05-10):
 - `Deploy-WinBuild2025.ps1` si occupa dell'**OS hardening** (Firewall, WinRM, UAC, Defender, UX tweaks, autologin Administrator, WU GPO locks). Se usato, Setup valida questi come Assert-Step senza re-applicarli.
- `Setup-WinBuild2025.ps1` si occupa della **CI customization** (utente `ci_build`, cartelle `C:\CI`, toolchain .NET/Python/VS, Windows Update lifecycle, cleanup, final gate).
+- `Install-CIToolchain-WinBuild2025.ps1` si occupa della **CI customization** (utente `ci_build`, cartelle `C:\CI`, toolchain .NET/Python/VS, Windows Update lifecycle, cleanup, final gate).

-`Prepare-WinBuild2025.ps1` apre una WinRM session, copia `Setup-WinBuild2025.ps1` in
+`Prepare-WinBuild2025.ps1` apre una WinRM session, copia `Install-CIToolchain-WinBuild2025.ps1` in
 `C:\CI\`, lo esegue, raccoglie l'exit code, valida lo stato del guest.

 ---
@@ -114,15 +114,15 @@ cd N:\Code\Workspace\Local-CI-CD-System\template

 Ogni step ha validazione `Assert-Step` (throw on failure, `[OK]` su pass):

-1. **Pre-flight**: script dir presente, `Setup-WinBuild2025.ps1` presente, IP ottetti 0-255, TCP/5986 reachable
+1. **Pre-flight**: script dir presente, `Install-CIToolchain-WinBuild2025.ps1` presente, IP ottetti 0-255, TCP/5986 reachable
 2. **Configura host WinRM client**: aggiunge `$VMIPAddress` ai `TrustedHosts` (no `AllowUnencrypted` — HTTPS non lo richiede)
   - Salva valore precedente, ripristinato nel `finally` (host posture invariata)
 3. **Validazione host WinRM**: `TrustedHosts` include IP
 4. **Test connettività**: `Test-WSMan -Port 5986 -UseSSL -Authentication Basic` con credenziali admin
 5. **Apre PSSession** `-UseSSL -Port 5986` verso la VM
 6. **Crea `C:\CI`** in guest, valida creazione
-7. **Copia `Setup-WinBuild2025.ps1`** in `C:\CI\Setup-WinBuild2025.ps1`, valida size match
-8. **Esegue `Setup-WinBuild2025.ps1`** dentro la VM (vedi Fase C)
+7. **Copia `Install-CIToolchain-WinBuild2025.ps1`** in `C:\CI\Install-CIToolchain-WinBuild2025.ps1`, valida size match
+8. **Esegue `Install-CIToolchain-WinBuild2025.ps1`** dentro la VM (vedi Fase C)
 9. **Gestisce reboot 3010**: se WU richiede reboot, riavvia VM e suggerisce re-run con `-SkipWindowsUpdate`
 10. **Post-setup remote validation** (9 check via singola `Invoke-Command`):
    - WinRM Running
@@ -145,13 +145,13 @@ Ogni step ha validazione `Assert-Step` (throw on failure, `[OK]` su pass):
 | `-BuildPassword`     | (prompt)      | Password per `ci_build` — mai hard-codare                                     |
 | `-BuildUsername`     | ci_build      | Account CI dentro la VM                                                       |
 | `-DotNetSdkVersion`  | 10.0          | Channel .NET SDK                                                              |
-| `-SkipWindowsUpdate` | (off)         | Pass-through a Setup-WinBuild2025.ps1                                         |
+| `-SkipWindowsUpdate` | (off)         | Pass-through a Install-CIToolchain-WinBuild2025.ps1                                         |
 | `-StoreCredential`   | (off)         | Registra `BuildUsername`/`BuildPassword` in Windows Credential Manager        |
 | `-CredentialTarget`  | BuildVMGuest  | Target Credential Manager (deve corrispondere a quanto usato da Invoke-CIJob) |

 ---

-## Fase C — Cosa fa `Setup-WinBuild2025.ps1` (dentro la VM)
+## Fase C — Cosa fa `Install-CIToolchain-WinBuild2025.ps1` (dentro la VM)

 Eseguito automaticamente da Prepare in Fase B. Steps 1/2/3/4b/5b/5c sono
 **validation-only** — verificano che Deploy abbia già applicato l'hardening OS.
@@ -295,7 +295,7 @@ toolchain (.NET, VS Build Tools, Python).
 | Sintomo                                        | Diagnosi / Fix                                                                                            |
 | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
 | `Cannot reach $VMIPAddress via WinRM`          | VM non avviata, WinRM non abilitato, IP errato — verifica con ipconfig                                    |
-| `Setup-WinBuild2025.ps1 exited with code 3010` | Reboot richiesto post-WU. Re-run con `-SkipWindowsUpdate`                                                 |
+| `Install-CIToolchain-WinBuild2025.ps1 exited with code 3010` | Reboot richiesto post-WU. Re-run con `-SkipWindowsUpdate`                                                 |
 | `[Defender] Validation failed: GPO key`        | Defender riattivato da Windows Update — disabilita via gpedit + reboot                                    |
 | `VS Build Tools installation timed out`        | Network slow o cache corrotta. Re-run con cache pulita (`C:\ProgramData\Microsoft\VisualStudio\Packages`) |
 | `Python version match` fail                    | `$PythonVersion` ≠ versione installata. Aggiorna param o reinstalla                                       |
@@ -312,3 +312,4 @@ toolchain (.NET, VS Build Tools, Python).
 - **§2.5 [P1]** Snapshot versionato `BaseClean_<yyyyMMdd>` (rollback in caso di refresh rotto)
 - **§2.6 [P2]** Backup automatico VMDK template pre-snapshot
 - **In-VM Git Clone** — installare Git for Windows + 7-Zip nel template per ottimizzare flusso
+