windows-verify: GCP / Windows Server support

GCP only offers Windows Server images, which lack winget. Rewrite
bootstrap-windows.ps1 to be winget-free (Chocolatey for git + VS Build Tools,
direct-from-Google for the Flutter SDK) and add a -SkipVS fast path — the
ConPTY soak only needs Flutter/Dart. Runs under Windows PowerShell 5.1. README
gains a self-contained GCP Cloud Shell runbook (create / reset-password / RDP /
stop / delete).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-14 21:23:12 +02:00
co-authored by Claude Opus 4.8
parent faacb732bc
commit 1c7fc7d786
2 changed files with 99 additions and 52 deletions
+31 -5
View File
@@ -20,6 +20,30 @@ Tooling to **verify (or refute) the Windows test-freeze assessment** for the
The leak (#1) is the **test-path** explanation and the actionable one. A VM is
the right instrument for it; it is the wrong instrument for #5.
## On a cloud VM (GCP) — no local hypervisor
If the host has no KVM (e.g. VT-x disabled in firmware), run this on a GCP
Windows Server instance instead — real hardware acceleration, nothing installed
locally. From the GCP Cloud Shell (browser; `gcloud` preinstalled):
```bash
gcloud compute instances create clide-win-verify \
--zone=us-central1-a --machine-type=e2-standard-4 \
--image-family=windows-2022 --image-project=windows-cloud \
--boot-disk-size=100GB --boot-disk-type=pd-ssd
gcloud compute reset-windows-password clide-win-verify --zone=us-central1-a --user=admin
```
RDP to the printed IP with the printed credentials (KDE: KRDC; or
`flatpak install flathub org.remmina.Remmina`). Then run steps 2-3 below inside
Windows (`bootstrap-windows.ps1 -SkipVS` is winget-free and Server-compatible).
Stop the VM when idle, delete it when done:
```bash
gcloud compute instances stop clide-win-verify --zone=us-central1-a # idle
gcloud compute instances delete clide-win-verify --zone=us-central1-a # done
```
## The three steps
1. **Provision the VM** (on the Fedora/KVM host — "danoontje"):
@@ -31,16 +55,18 @@ the right instrument for it; it is the wrong instrument for #5.
Finish the interactive Windows install in `virt-viewer` (load the virtio
disk driver from the second CD during setup).
2. **Bootstrap the toolchain** (inside Windows, elevated PowerShell):
2. **Bootstrap the toolchain** (inside Windows, elevated PowerShell). No winget
dependency, so this also works on Windows Server / GCP images. For the soak,
`-SkipVS` installs only Flutter/Dart:
```powershell
pwsh -File tools\windows-verify\bootstrap-windows.ps1
powershell -ExecutionPolicy Bypass -File tools\windows-verify\bootstrap-windows.ps1 -SkipVS
```
Installs Git, Flutter/Dart, and VS 2022 Build Tools (C++ workload), then
clones + checks out `windows-support` and builds the C CLI.
Drop `-SkipVS` to also install VS 2022 Build Tools (needed only for
`flutter build windows` + the C CLI). Clones + checks out `windows-support`.
3. **Run the soak** (new shell, so PATH is fresh):
```powershell
pwsh -File tools\windows-verify\soak-conpty.ps1 -Iterations 40
powershell -ExecutionPolicy Bypass -File tools\windows-verify\soak-conpty.ps1 -Iterations 40
```
## Reading the result
+68 -47
View File
@@ -1,81 +1,102 @@
<#
.SYNOPSIS
Provision a Windows VM (or bare machine) with everything needed to build and
test clide's windows-support branch, then run the ConPTY soak.
Provision a fresh Windows machine (including a GCP Compute Engine Windows
Server instance) to build and test clide's windows-support branch, then run
the ConPTY soak. No winget dependency — works on Windows Server images that
don't ship the Store.
.DESCRIPTION
Installs (via winget): Git, the Flutter SDK (brings Dart), and Visual Studio
2022 Build Tools with the C++ desktop workload — required for both the
ConPTY FFI path and the `clide.c` AF_UNIX CLI (ws2_32 / afunix). Then clones
the repo, checks out the branch, runs `flutter pub get`, and builds the C
client. Nothing here freezes the box; it just gets you to a runnable state.
Installs Git (via Chocolatey) and the Flutter SDK (direct from Google's
current stable — brings Dart). With -SkipVS it stops there: the ConPTY soak
only needs Flutter/Dart (windows_pty.dart loads kernel32 at runtime). Without
-SkipVS it also installs VS 2022 Build Tools (C++ workload) for
`flutter build windows` + the C CLI. Then clones + checks out the branch and
runs `flutter pub get`. Runs under Windows PowerShell 5.1 (no pwsh needed).
Run from an ELEVATED PowerShell (winget package installs need admin). After
it finishes, open a NEW shell so PATH updates take effect, then run
soak-conpty.ps1.
Run from an ELEVATED PowerShell (Chocolatey + machine PATH need admin). On a
fresh VM, fetch this script first:
iwr https://raw.githubusercontent.com/postmeridiem/clide/windows-support/tools/windows-verify/bootstrap-windows.ps1 -OutFile $env:TEMP\bootstrap.ps1
powershell -ExecutionPolicy Bypass -File $env:TEMP\bootstrap.ps1 -SkipVS
.PARAMETER RepoUrl Git remote (default: the GitHub origin).
.PARAMETER Branch Branch to check out (default: windows-support).
.PARAMETER Dest Checkout directory (default: %USERPROFILE%\src\clide).
.PARAMETER RepoUrl Git remote (default: GitHub origin).
.PARAMETER Branch Branch to check out (default: windows-support).
.PARAMETER Dest Checkout directory (default: %USERPROFILE%\src\clide).
.PARAMETER SkipVS Skip VS Build Tools — enough for the ConPTY soak.
#>
[CmdletBinding()]
param(
[string] $RepoUrl = 'https://github.com/postmeridiem/clide.git',
[string] $Branch = 'windows-support',
[string] $Dest = "$env:USERPROFILE\src\clide"
[string] $Dest = "$env:USERPROFILE\src\clide",
[switch] $SkipVS
)
$ErrorActionPreference = 'Stop'
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
if (-not (Get-Command winget -ErrorAction SilentlyContinue)) {
throw "winget not found. Install 'App Installer' from the Microsoft Store (or use a Win11/Server 2022+ image)."
}
function Install-Pkg([string]$id, [string]$override = $null) {
Write-Host "==> winget install $id" -ForegroundColor Cyan
$args = @('install', '--id', $id, '-e', '--accept-source-agreements', '--accept-package-agreements')
if ($override) { $args += @('--override', $override) }
winget @args
if ($LASTEXITCODE -ne 0 -and $LASTEXITCODE -ne -1978335189) { # -1978335189 = already installed
throw "winget install $id failed ($LASTEXITCODE)"
function Add-PersistentPath([string] $dir) {
if (";$env:Path;" -notlike "*;$dir;*") { $env:Path = "$dir;$env:Path" }
$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
if (";$userPath;" -notlike "*;$dir;*") {
[Environment]::SetEnvironmentVariable('Path', "$dir;$userPath", 'User')
}
}
Install-Pkg 'Git.Git'
Install-Pkg 'Flutter.Flutter' # provides flutter + bundled dart
# VS 2022 Build Tools with the native C++ desktop workload (cl.exe, ws2_32, afunix.h).
Install-Pkg 'Microsoft.VisualStudio.2022.BuildTools' `
'--quiet --wait --norestart --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended'
# -- Chocolatey (works on Server images that lack winget) -------------------
if (-not (Get-Command choco -ErrorAction SilentlyContinue)) {
Write-Host '==> installing Chocolatey' -ForegroundColor Cyan
Set-ExecutionPolicy Bypass -Scope Process -Force
Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
Add-PersistentPath "$env:ProgramData\chocolatey\bin"
}
# Re-resolve PATH for this session so the freshly installed tools are visible.
$env:Path = [System.Environment]::GetEnvironmentVariable('Path','Machine') + ';' +
[System.Environment]::GetEnvironmentVariable('Path','User')
# -- Git --------------------------------------------------------------------
if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
Write-Host '==> installing Git' -ForegroundColor Cyan
choco install -y git
Add-PersistentPath "$env:ProgramFiles\Git\cmd"
}
if (-not (Get-Command git -ErrorAction SilentlyContinue)) { throw "git not on PATH after install — open a new shell and re-run from the clone step." }
if (-not (Get-Command flutter -ErrorAction SilentlyContinue)) { throw "flutter not on PATH after install — open a new shell and re-run from the clone step." }
# -- Flutter (direct from Google; brings Dart) ------------------------------
if (-not (Get-Command flutter -ErrorAction SilentlyContinue)) {
Write-Host '==> installing Flutter (current stable)' -ForegroundColor Cyan
$rel = Invoke-RestMethod 'https://storage.googleapis.com/flutter_infra_release/releases/releases_windows.json'
$cur = $rel.releases | Where-Object { $_.channel -eq 'stable' } | Select-Object -First 1
$zip = "$env:TEMP\flutter-stable.zip"
Invoke-WebRequest -Uri "$($rel.base_url)/$($cur.archive)" -OutFile $zip
$toolsDir = "$env:USERPROFILE\tools"
New-Item -ItemType Directory -Force -Path $toolsDir | Out-Null
Expand-Archive -Path $zip -DestinationPath $toolsDir -Force # creates $toolsDir\flutter
Add-PersistentPath "$toolsDir\flutter\bin"
}
# -- VS Build Tools (C++) — only when building, NOT for the soak ------------
if (-not $SkipVS) {
Write-Host '==> installing VS 2022 Build Tools (C++ workload)' -ForegroundColor Cyan
choco install -y visualstudio2022buildtools `
--package-parameters '--add Microsoft.VisualStudio.Workload.VCTools --includeRecommended'
}
# refresh PATH so the just-installed tools resolve in THIS session
$env:Path = [Environment]::GetEnvironmentVariable('Path', 'Machine') + ';' + [Environment]::GetEnvironmentVariable('Path', 'User')
if (-not (Get-Command git -ErrorAction SilentlyContinue)) { throw 'git not on PATH — open a new admin shell and re-run.' }
if (-not (Get-Command flutter -ErrorAction SilentlyContinue)) { throw 'flutter not on PATH — open a new admin shell and re-run.' }
# -- clide ------------------------------------------------------------------
if (-not (Test-Path $Dest)) {
Write-Host "==> git clone $RepoUrl -> $Dest" -ForegroundColor Cyan
Write-Host "==> git clone -> $Dest" -ForegroundColor Cyan
git clone $RepoUrl $Dest
}
Push-Location $Dest
try {
git fetch origin $Branch
git checkout $Branch
Write-Host "==> flutter pub get" -ForegroundColor Cyan
Write-Host '==> flutter pub get' -ForegroundColor Cyan
flutter pub get
# Build the C CLI (needs the VS toolset; ci/build_cli_windows.sh wraps cl.exe).
# Requires a bash — Git for Windows ships one at /usr/bin/bash.
$bash = Join-Path $env:ProgramFiles 'Git\bin\bash.exe'
if (Test-Path $bash) {
Write-Host "==> build C CLI (ci/build_cli_windows.sh)" -ForegroundColor Cyan
& $bash -lc "cd '$($Dest -replace '\\','/')' && ci/build_cli_windows.sh"
} else {
Write-Warning "Git Bash not found; skipping C CLI build. Build later with 'make clide-cli' from Git Bash."
}
}
finally { Pop-Location }
Write-Host "`nReady. Open a NEW shell, then:" -ForegroundColor Green
Write-Host " cd $Dest"
Write-Host " pwsh -File tools\windows-verify\soak-conpty.ps1 -Iterations 40"
Write-Host " powershell -ExecutionPolicy Bypass -File tools\windows-verify\soak-conpty.ps1 -Iterations 40"