utils/vmbox/lib/repo.sh
Krzysztof kuhy Rudnicki 694c013b6b
Some checks failed
dependency freshness / dependencies on newest stable (push) Has been cancelled
file length / file-length (push) Has been cancelled
md-naming / markdown naming convention (push) Has been cancelled
palette drift / palette (push) Has been cancelled
shared gate tests / gate unit tests (push) Has been cancelled
vmbox: UEFI sandboxes and 'vm wake' RTC-wake emulation for poweroff/hibernate; worktree copies skip gitignored files
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-10-01 12:29:54 +02:00

103 lines
4.2 KiB
Bash

#!/bin/bash
# ============================================================================
# vmbox: get a host repo into a sandbox.
#
# Two modes, because they answer different questions:
# clone (default) -- reproducible: tests exactly what is committed at HEAD
# worktree -- tests what is on disk right now, uncommitted edits and
# all, which is usually what "does this script work?" means
#
# The host side is always mounted READ-ONLY, so nothing the guest does can
# reach the real repo.
# ============================================================================
# shellcheck source=common.sh
source "$(dirname "${BASH_SOURCE[0]}")/common.sh"
source "$(dirname "${BASH_SOURCE[0]}")/ssh.sh"
readonly GUEST_MOUNT="/mnt/hostrepo"
# Expose a host directory to sandboxes. Bind-mount rather than symlink: 9p
# exports a directory TREE and does not follow links out of it, so a symlinked
# repo appears in the guest as a dangling link (measured, not assumed).
# The bind is read-only, so the guest cannot write to the real repo.
repo_share() {
local src="${1:-}" name share
[[ -n "$src" ]] || die "usage: vm share <host-path>"
[[ -d "$src" ]] || die "no such directory: $src"
src="$(realpath "$src")"
name="$(basename "$src")"
share="${VMBOX_SHARE:-$VMBOX_HOME/share}"
install -d -m 755 "$share/$name"
if mountpoint -q "$share/$name"; then
ok "$name is already shared"
return 0
fi
# A read-only bind needs two steps: mount, then remount ro.
sudo mount --bind "$src" "$share/$name" ||
die "bind mount failed (needs sudo once per boot)"
sudo mount -o remount,ro,bind "$share/$name" ||
warn "could not remount read-only -- the guest mount is still ro via 9p"
ok "shared $src -> sandboxes see it at $GUEST_MOUNT/$name (read-only)"
}
repo_unshare() {
local name="${1:-}" share
share="${VMBOX_SHARE:-$VMBOX_HOME/share}"
[[ -n "$name" ]] || die "usage: vm unshare <name>"
mountpoint -q "$share/$name" || { ok "$name is not shared"; return 0; }
sudo umount "$share/$name" || die "umount failed"
rmdir "$share/$name" 2>/dev/null || true
ok "unshared $name"
}
# $1 vm name, $2 host repo path, $3 mode (clone|worktree)
repo_sync() {
local name="$1" src="$2" mode="${3:-clone}" repo_name
require_vm "$name"
[[ -d "$src" ]] || die "no such directory: $src"
repo_name="$(basename "$src")"
vm_is_running "$name" || die "sandbox '$name' is not running"
# Warn about a dirty tree: another session's uncommitted work is a real
# hazard, and it silently changes what a `clone` actually tests.
if [[ -d "$src/.git" ]] && ! git -C "$src" diff --quiet 2>/dev/null; then
warn "host repo has uncommitted changes"
[[ "$mode" == clone ]] &&
warn " mode=clone tests HEAD, NOT those edits (use --worktree for them)"
fi
case "$mode" in
clone) _repo_clone "$name" "$src" "$repo_name" ;;
worktree) _repo_rsync "$name" "$src" "$repo_name" ;;
*) die "unknown repo mode '$mode' (use: clone | worktree)" ;;
esac
}
_repo_clone() {
local name="$1" src="$2" repo_name="$3"
[[ -d "$src/.git" ]] || die "$src is not a git repo (use --worktree instead)"
log "Cloning $repo_name into '$name' (HEAD, reproducible)"
# --no-hardlinks: never link into the read-only host mount.
vm_ssh_exec "$name" \
"rm -rf ~/$repo_name && git clone --no-hardlinks -q $GUEST_MOUNT/$repo_name ~/$repo_name" ||
die "clone failed"
local head
head="$(vm_ssh_exec "$name" "git -C ~/$repo_name rev-parse --short HEAD" 2>/dev/null)"
ok "$repo_name cloned at $head (committed state)"
}
# Gitignored files are skipped: build output (a Flutter app's build/ and
# .dart_tool/ run to gigabytes) is not "the edits in front of you", and
# pushing it through 9p OOM-killed a 4 GiB-capped harness (2026-10-01).
_repo_rsync() {
local name="$1" src="$2" repo_name="$3"
log "Copying $repo_name into '$name' (working tree, including uncommitted edits)"
vm_ssh_exec "$name" \
"rsync -a --exclude .git --filter=':- .gitignore' $GUEST_MOUNT/$repo_name/ ~/$repo_name/" ||
die "rsync failed"
ok "$repo_name copied (working-tree state)"
}