Simone
dd238121b3
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.
135 lines
4.3 KiB
PowerShell
135 lines
4.3 KiB
PowerShell
#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"
|