diff options
| author | Craig Jennings <c@cjennings.net> | 2026-02-24 08:03:34 -0600 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-02-24 08:03:34 -0600 |
| commit | 4128e68b07103672a385178b413321d6193f2d4f (patch) | |
| tree | 8d95a62f17a6af9574db4e2da8599508ebd42711 /testing-strategy.org | |
| parent | 7359b3d59d89378711aae5635c8d569d79cc87d4 (diff) | |
| download | archangel-4128e68b07103672a385178b413321d6193f2d4f.tar.gz archangel-4128e68b07103672a385178b413321d6193f2d4f.zip | |
docs: add Running Tests section to testing strategy, link from README
Diffstat (limited to 'testing-strategy.org')
| -rw-r--r-- | testing-strategy.org | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/testing-strategy.org b/testing-strategy.org index 3119917..6ae0e6f 100644 --- a/testing-strategy.org +++ b/testing-strategy.org @@ -7,6 +7,39 @@ This document describes the testing strategy for the archzfs installer project, including automated VM testing and the rationale for key technical decisions. +* Running Tests + +** Makefile Targets + +| Target | Description | +|--------+-------------| +| =make test-install= | Run all 12 automated install tests (builds ISO first) | +| =make test-vm= | Boot ISO in a single-disk VM (interactive) | +| =make test-multi= | Boot ISO in a 2-disk VM for mirror/RAID testing | +| =make test-multi3= | Boot ISO in a 3-disk VM for raidz1 testing | +| =make test-boot= | Boot from installed disk (after running install in VM) | +| =make test-clean= | Remove VM disks and OVMF vars, start fresh | +| =make lint= | Run shellcheck on all scripts | +| =make test= | Run lint (alias) | + +** Running a Single Automated Test + +#+begin_src bash +./scripts/test-install.sh zfs-encrypt +#+end_src + +** Running Multiple Specific Tests + +#+begin_src bash +./scripts/test-install.sh zfs-encrypt zfs-mirror-encrypt btrfs-luks +#+end_src + +** Listing Available Test Configs + +#+begin_src bash +./scripts/test-install.sh --list +#+end_src + * Test Infrastructure ** Test Scripts |