feat: cluster test framework

.woodpecker/test-vm.yaml

@@ -0,0 +1,39 @@
+# PR-only, KVM.
+# Build nixosTestConfigurations.* for affected server/scenario hosts.
+# Independent of check.yaml.
+
+labels:
+  platform: linux/amd64
+  kvm: true
+
+when:
+  - event: pull_request
+
+steps:
+  - name: Build VM tests
+    image: registry.racci.dev/lix-woodpecker:latest
+    pull: true
+    environment:
+      binary_cache_token:
+        from_secret: binary_cache_token
+    commands: |
+      nix run .#setup-attic -- --watch
+      nix run .#archive-flakes -- "." "flake/nixos"
+
+  - name: Run VM tests
+    image: registry.racci.dev/lix-woodpecker:latest
+    commands: |
+      affected_hosts=$(git diff --name-only "origin/${CI_COMMIT_TARGET_BRANCH:-main}...HEAD" 2>/dev/null | grep -oP '(?<=^hosts/server/)[^/]+' | sort -u)
+      affected_scenarios=$(git diff --name-only "origin/${CI_COMMIT_TARGET_BRANCH:-main}...HEAD" 2>/dev/null | grep -oP '(?<=^tests/scenarios/)[^/]+' | sort -u)
+      if [ -z "$affected_hosts" ] && [ -z "$affected_scenarios" ]; then
+        hosts=$(nix eval .#nixosTestConfigurations --apply 'builtins.attrNames' --json | jq -r '.[]')
+      else
+        hosts=$(printf '%s\n%s' "$affected_hosts" "$affected_scenarios" | sort -u)
+      fi
+      failed=0
+      for host in $hosts; do
+        echo "::group::VM test: $host"
+        nix build ".#nixosTestConfigurations.$host" --no-link -L || { failed=1; echo "FAILED: $host"; }
+        echo "::endgroup::"
+      done
+      exit $failed

docs/src/SUMMARY.md

@@ -16,6 +16,7 @@
 - [Adding an External Package](development/adding_an_external_package.md)
 - [Declarative Gnome Dconf](development/declarative_gnome_dconf.md)
 - [Using a Package/Module from a Fork](development/using_a_nix_package_or_nixos_module_from_a_separate_fork_of_nixpkgs.md)
+- [VM Integration Tests](development/vm_integration_tests.md)
 
 # Modules