Nucleic: Gitea Runner macOS VM Support

2026-08-07 01:40:57 -07:00
parent 697a4cdcd0
commit ab4ed9c8a1
4 changed files with 302 additions and 7 deletions
@@ -315,6 +315,17 @@ find it. `--ipsw` is optional: omit it and the latest supported restore image is
 downloaded into `storeDir/ipsw/` first, which is most of the build's wall-clock
 time. `--disk-gb` overrides `guest.diskGB` for this image only.

+`--ipsw` (and `image provision --xcode-xip`) accept a `~` and a glob, quoted or not — these are
+equivalent, and neither depends on what your shell did with the pattern first:
+
+```sh
+gitea-macos-runner image build --ipsw ~/Downloads/UniversalMac_27.0_*.ipsw
+gitea-macos-runner image build --ipsw '~/Downloads/UniversalMac_27.0_*.ipsw'
+```
+
+A pattern must identify exactly one file. If it matches several, the build stops before doing any
+work and lists them so you can name the one you meant; if it matches none, it says so.
+
 This takes a long time — macOS installs from the IPSW, boots, and is then provisioned over SSH.
 **Do not interrupt it during the install phase.** Stopping a VM mid-install leaves the disk image
 in an undefined state; delete the image and start over rather than trying to resume.