Make Targets For Development¶
The repository exposes a small root Makefile plus a larger matrix Makefile under tests/.
Root targets¶
These are the day-to-day entry points most developers use from the repository root.
| Target | Purpose |
|---|---|
make bootstrap |
Run the interactive bootstrap flow in its default single-node mode |
make dry-run |
Run the bootstrap flow in planning mode without applying changes |
make backup |
Capture a host and cluster backup snapshot |
make validate |
Run the stack validator |
make validate-strict |
Treat warnings as failures in validation |
make docs-build |
Build the MkDocs site strictly |
make docs-serve |
Serve the docs locally |
make docs-up |
Start the docs server in the background |
make docs-down |
Stop the local docs server and clean its artifacts |
make docs-clean |
Clean docs artifacts and local docs virtualenv |
Focused test targets¶
The root Makefile also exposes a set of developer-friendly test entry points:
| Target | Purpose |
|---|---|
make test-bootstrap-modes |
Verify that bootstrap mode CLI help and validation behave correctly |
make test-agent-smoke |
Exercise the agent mode in Docker |
make test-smoke |
Run a Docker-based smoke check for bootstrap dry-run |
make test-core |
Run the core VM profile on Ubuntu 24.04 |
make test-core-debian12 |
Run the core VM profile on Debian 12 |
make test-core-debian13 |
Run the core VM profile on Debian 13 |
Matrix targets¶
For broader coverage, the root Makefile delegates to tests/Makefile:
| Target | Purpose |
|---|---|
make test-matrix-smoke |
Run the smoke matrix across Ubuntu and Debian |
make test-matrix-core |
Run the core matrix across Ubuntu and Debian |
make test-matrix-full |
Run the full matrix across Ubuntu and Debian |
make test-matrix-full-rollback |
Run the full-rollback matrix across Ubuntu and Debian |
make test-matrix-full-clean |
Run the full-clean matrix across Ubuntu and Debian |
make test-matrix-all |
Run all matrix profiles in sequence |
Useful direct tests/Makefile targets¶
When you need narrower iteration loops, use make -C tests ....
Examples:
make -C tests smoke-ubuntu-24.04make -C tests core-debian12make -C tests full-rollback-ubuntu-22.04make -C tests clean-test-artifacts
Notes¶
Note
The root targets are convenience entry points. The deeper matrix granularity lives in tests/Makefile.
Note
For documentation work, make docs-build is the safest final check because it runs MkDocs in strict mode.