summaryrefslogtreecommitdiff
path: root/integrationtests/README.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-02-23 17:27:08 +0200
committerPaul Buetow <paul@buetow.org>2026-02-23 17:27:08 +0200
commitaa19be8c624a6adc3ecbf11a6ee0506a5c7d34fe (patch)
tree6abf6475155980c4c663d04c24ac8f15ca51a166 /integrationtests/README.md
parent80d68b05199d288df8ccd7a073ac32ebfc90be62 (diff)
Run integration tests in parallel by default and stabilize flaky scenarios
Diffstat (limited to 'integrationtests/README.md')
-rw-r--r--integrationtests/README.md11
1 files changed, 6 insertions, 5 deletions
diff --git a/integrationtests/README.md b/integrationtests/README.md
index 8de7439..601b782 100644
--- a/integrationtests/README.md
+++ b/integrationtests/README.md
@@ -15,20 +15,21 @@ harness asserts the captured `.ior.zst` output matches expectations.
mage integrationTest
```
-This builds everything (ior, ioworkload) and runs the test suite with `sudo`.
+This builds everything (ior, ioworkload) and runs integration tests in parallel.
+Default parallelism is half of available CPU cores (minimum `1`).
Tests automatically skip with `t.Skip` when not running as root.
-To opt into parallel scenario execution:
+To run serially (useful for debugging/flaky triage):
```bash
-mage integrationTestParallel
+mage integrationTestSerial
```
-Tune parallelism by setting `INTEGRATION_PARALLEL` (default `8`), for example:
+Tune parallelism by setting `INTEGRATION_PARALLEL`, for example:
```bash
-INTEGRATION_PARALLEL=4 mage integrationTestParallel
+INTEGRATION_PARALLEL=4 mage integrationTest
```
## Structure