authoravatarclover caruso<git@paperclover.net>2026-11-17 04:44:08-08:00
committeravatarclover caruso<git@paperclover.net>2026-11-22 00:44:02-08:00
logae780a97cef655e25547c8351b3d3cb730b6370c
tree7e6c7c9c9a8562217c8799b7c8607c96dfa9de6a
parentc39854bcb4d98462f03c79c2dcc64c894cf98aab
signature Signed by SSH key SHA256:52mNGHRsVFBDED9IAX5pe+LRWUefqTbxEReunq21QvU

Document the prepared Windows development image

Link the reusable SDK recipe and guest manifest, explain preset resource recommendations, and correct the system context required for template preparation. Assisted-by: gpt-6.1-sol

1 files changed, 15 insertions(+), 5 deletions(-)

tools/windows-presets.md+15-5
...@@ -7,7 +7,7 @@ preserving older bases. Host paths come from the configured VM library root....@@ -7,7 +7,7 @@ preserving older bases. Host paths come from the configured VM library root.
77
8The provisioning contract is [windows-provision.ps1](../guest/windows-provision.ps1).8The provisioning contract is [windows-provision.ps1](../guest/windows-provision.ps1).
9Prepare an isolated template with its account named `sandbox`, then run that9Prepare an isolated template with its account named `sandbox`, then run that
10script with `-Prepare` from elevated 64-bit Windows PowerShell. Preparation10script with `-Prepare` from 64-bit Windows PowerShell running as `SYSTEM`. Preparation
11randomizes the template password, removes clone identity and completion state,11randomizes the template password, removes clone identity and completion state,
12and installs the startup task. Shut down normally before capturing through12and installs the startup task. Shut down normally before capturing through
13`vms.save_preset` with `setup=windows-v4`. The dashboard deliberately rejects13`vms.save_preset` with `setup=windows-v4`. The dashboard deliberately rejects
...@@ -25,6 +25,18 @@ sign-out/sign-in so the desktop inherits the selected username, without a second...@@ -25,6 +25,18 @@ sign-out/sign-in so the desktop inherits the selected username, without a second
25OS boot. Each clone still gets a separate password, MAC address, and DHCP lease.25OS boot. Each clone still gets a separate password, MAC address, and DHCP lease.
26Published `windows-v3` bases keep their original rename-and-reboot seed contract.26Published `windows-v3` bases keep their original rename-and-reboot seed contract.
2727
28## Development image
29
30`windows-11-pro-development-v1` adds the C++ build tools and Windows SDK, Rust,
31Node/pnpm, Python and Git. Its installed versions, installer hashes and recipe
32hash are recorded in `C:\Snowglobe\development.json`. `computer_presets` exposes
33the image's recommended resources; its memory and disk values are bytes.
34
35Run [windows-development.ps1](../guest/windows-development.ps1) from the elevated
36desktop account before template preparation. The toolchains use machine-wide
37paths and were verified with ordinary desktop privileges and fresh account names.
38The development image is a separate family; clean Windows images keep their IDs.
39
28## 2026-10-20 rollout40## 2026-10-20 rollout
2941
30The `windows-10-pro-v10` candidate was prepared and tested on HDD storage with42The `windows-10-pro-v10` candidate was prepared and tested on HDD storage with
...@@ -72,10 +84,8 @@ identity changes at 1.83 seconds; the host's polling rounds this to 2.08 seconds...@@ -72,10 +84,8 @@ identity changes at 1.83 seconds; the host's polling rounds this to 2.08 seconds
72Two Kernel-General boot events confirmed the reboot. Explorer and guest capture84Two Kernel-General boot events confirmed the reboot. Explorer and guest capture
73were running, and the production browser displayed the personalized desktop.85were running, and the production browser displayed the personalized desktop.
7486
75This is a disk template, not a saved-memory resume. `Rename-Computer` in the87The v10 trace used a disk template with `Rename-Computer` and a restart before
76provisioning script is followed by a forced restart; the second boot enables88desktop capture. Cloning the disk itself was already inexpensive.
77capture and waits for the desktop. Avoiding that second boot is the next
78architectural opportunity. Cloning the disk itself is already inexpensive.
7989
80By `ready`, QEMU recorded 474 flushes with 46.45 seconds of aggregate duration90By `ready`, QEMU recorded 474 flushes with 46.45 seconds of aggregate duration
81(98 ms per flush), 2.24 GB read, and 105 MB written. These operation durations91(98 ms per flush), 2.24 GB read, and 105 MB written. These operation durations