Windows minion image cook

Prepare a Windows Server 2022 or 2025 VM as a vPorter OS-morphing minion image. Min 20GB Volume size. Run from a VHI management node inside the cluster.

Script

scripts/prepare-windows-minion-from-host.sh — self-contained (embeds cook + winrm-gen.ps1). Resolves id/host via vinfra, runs virsh over ssh -i /etc/kolla/id_rsa root@$HOST, uploads with qemu-ga guest-file-*, polls until DONE/FAILED, stops the VM, lists attached volumes, and prints manual Glance upload commands.

Needs: English Windows Server 2022 with QEMU Guest Agent (create the VM in VHI so guest tools install automatically).

Usage

ADMIN_PASSWORD='...' \
VINFRA_USERNAME=admin \
VINFRA_PASSWORD='...' \
./scripts/prepare-windows-minion-from-host.sh <vm-uuid>

After cook, pick the OS disk volume id from the printed list and upload:

vinfra service compute volume upload-to-image --wait --name vporter-minion-windows <volume_id>

Useful env: SKIP_SHUTDOWN=1, COOK_TIMEOUT, DEBUG=1 (./scripts/prepare-windows-minion-from-host.sh --help).

Guest log: C:\Windows\Temp\prepare-windows-minion-image.log.

Cook steps (guest)

1. Validate Windows flavor (x64 , en-US)
2. Set Administrator password, allow ICMPv4 echo
3. Install Cloudbase-Init
4. Enable WinRM HTTPS :5986
5. Install Windows ADK Deployment Tools (DISM_LEGACY)
6. Patch Cloudbase-Init configs
7. Readiness checks