chore: initial commit local CI/CD system (e2e verified, production-ready)

Sistema CI locale basato su VMware Workstation + Gitea Actions + act_runner. Testato e2e con nsis-plugin-nsinnounp (MSBuild + Python, 4 configurazioni parallele). - scripts/: Invoke-CIJob, Invoke-RemoteBuild, New/Remove-BuildVM, Wait-VMReady, Get-BuildArtifacts - runner/: act_runner config (windows-build label, capacity 4) - gitea/workflows/: build-nsis.yml (template per progetti MSBuild/Python) - template/: script di provisioning template VM (VS BuildTools 2026, .NET SDK 10, Python 3.13) - docs/: ARCHITECTURE, CI-FLOW, OPTIMIZATION, BEST-PRACTICES, Setup-GiteaSSH Verificato: e2e-009 SUCCESS in 02:09, cleanup automatico VM confermato.
2026-05-08 23:25:50 +02:00
commit dd238121b3
21 changed files with 3574 additions and 0 deletions
@@ -0,0 +1,134 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+    Waits until a build VM is fully ready to accept WinRM connections.
+
+.DESCRIPTION
+    Performs a three-phase readiness check in a polling loop:
+      1. vmrun getState returns "running"
+      2. ICMP ping succeeds
+      3. Test-WSMan (WinRM) responds without error
+
+    Throws if the VM does not become ready within the timeout period.
+
+.PARAMETER VMPath
+    Full path to the clone VM's .vmx file.
+
+.PARAMETER IPAddress
+    IP address of the VM on the build network (e.g. 192.168.11.101).
+
+.PARAMETER TimeoutSeconds
+    Maximum seconds to wait for the VM to become ready.
+    Default: 300 (5 minutes)
+
+.PARAMETER PollIntervalSeconds
+    Seconds between readiness checks.
+    Default: 5
+
+.PARAMETER VmrunPath
+    Full path to vmrun.exe.
+    Default: C:\Program Files (x86)\VMware\VMware Workstation\vmrun.exe
+
+.EXAMPLE
+    .\Wait-VMReady.ps1 `
+        -VMPath    "F:\CI\BuildVMs\Clone_run-42_20260508_143022\Clone_run-42_20260508_143022.vmx" `
+        -IPAddress "192.168.11.101"
+#>
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory)]
+    [string] $VMPath,
+
+    [Parameter(Mandatory)]
+    [ValidatePattern('^(\d{1,3}\.){3}\d{1,3}$')]
+    [string] $IPAddress,
+
+    [ValidateRange(30, 600)]
+    [int] $TimeoutSeconds = 300,
+
+    [ValidateRange(3, 30)]
+    [int] $PollIntervalSeconds = 5,
+
+    [string] $VmrunPath = 'C:\Program Files (x86)\VMware\VMware Workstation\vmrun.exe',
+
+    # Skip ICMP ping phase (phase 2). Useful when the guest firewall blocks ICMP
+    # but WinRM (TCP 5985) is open. Phase 1 (vmrun state) and phase 3 (WinRM)
+    # are still checked.
+    [switch] $SkipPing
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+if (-not (Test-Path $VmrunPath -PathType Leaf)) {
+    throw "vmrun.exe not found at: $VmrunPath"
+}
+
+$deadline    = (Get-Date).AddSeconds($TimeoutSeconds)
+$attempt     = 0
+$phase       = 'vmrun-state'   # tracks current phase for informative output
+$lastPhase   = ''
+
+Write-Host "[Wait-VMReady] Waiting for VM ready (timeout: ${TimeoutSeconds}s, IP: $IPAddress)..."
+
+while ((Get-Date) -lt $deadline) {
+    $attempt++
+
+    # ── Phase 1: VM must be running ─────────────────────────────────────
+    # vmrun has no getState; getGuestIPAddress fails with "not powered on"
+    # when the VM is off, and succeeds (exit 0) when running.
+    try {
+        & $VmrunPath getGuestIPAddress $VMPath 2>&1 | Out-Null
+        $isRunning = ($LASTEXITCODE -eq 0)
+    }
+    catch {
+        $isRunning = $false
+    }
+
+    if (-not $isRunning) {
+        if ($phase -ne 'vmrun-state') {
+            $phase = 'vmrun-state'
+        }
+        if ($lastPhase -ne $phase) {
+            Write-Host "[Wait-VMReady] Phase 1/3: waiting for VM to enter running state..."
+            $lastPhase = $phase
+        }
+        Start-Sleep -Seconds $PollIntervalSeconds
+        continue
+    }
+
+    # ── Phase 2: Network ping (optional) ───────────────────────────────
+    if (-not $SkipPing) {
+        $pingOk = Test-Connection -ComputerName $IPAddress -Count 1 -Quiet -ErrorAction SilentlyContinue
+
+        if (-not $pingOk) {
+            $phase = 'ping'
+            if ($lastPhase -ne $phase) {
+                Write-Host "[Wait-VMReady] Phase 2/3: VM running, waiting for network (ping $IPAddress)..."
+                $lastPhase = $phase
+            }
+            Start-Sleep -Seconds $PollIntervalSeconds
+            continue
+        }
+    }
+
+    # ── Phase 3: WinRM responsive ────────────────────────────────────────
+    try {
+        Test-WSMan -ComputerName $IPAddress -ErrorAction Stop | Out-Null
+        # Success — VM is ready
+        $elapsed = ($deadline - (Get-Date)).Negate().TotalSeconds + $TimeoutSeconds
+        Write-Host "[Wait-VMReady] VM ready after ~$([int]($attempt * $PollIntervalSeconds))s (attempt $attempt)."
+        return
+    }
+    catch {
+        $phase = 'winrm'
+        if ($lastPhase -ne $phase) {
+            Write-Host "[Wait-VMReady] Phase 3/3: ping OK, waiting for WinRM on port 5985..."
+            $lastPhase = $phase
+        }
+        Start-Sleep -Seconds $PollIntervalSeconds
+        continue
+    }
+}
+
+throw "[Wait-VMReady] Timed out after ${TimeoutSeconds}s waiting for VM at $IPAddress to become ready. Last phase: $phase"