summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorAntoine Eiche <lewo@abesis.fr>2021-07-10 16:05:25 +0200
committerAntoine Eiche <lewo@abesis.fr>2021-07-12 22:57:01 +0200
commita0f9688a31dd9f4b6f9d252ba06f8d1acef914af (patch)
tree94b7cd246366ce02b0b5fa677074d6547136f36c /docs
parenta9f87ca461a1f0e23e85a1ba8c696672ed9e11e2 (diff)
Switch CI to Nix flakes
We also move tests to Flakes. This would allow users to submit PRs with a fork of nixpkgs when they want to test nixpkgs PRs against SNM.
Diffstat (limited to 'docs')
-rw-r--r--docs/howto-develop.rst18
1 files changed, 14 insertions, 4 deletions
diff --git a/docs/howto-develop.rst b/docs/howto-develop.rst
index b12c9b9..5eb4e57 100644
--- a/docs/howto-develop.rst
+++ b/docs/howto-develop.rst
@@ -9,13 +9,23 @@ You can also chat with us on the Libera IRC channel ``#nixos-mailserver``.
Run NixOS tests
---------------
-You can run the testsuite via
+To run the test suite, you need to enable `Nix Flakes
+<https://nixos.wiki/wiki/Flakes#Installing_flakes>`.
+
+You can then run the testsuite via
+
+::
+
+ $ nix flake check -L
+
+Since Nix doesn't garantee your machine have enough resources to run
+all test VMs in parallel, some tests can fail. You would then haev to
+run tests manually. For instance:
::
- $ nix-build tests -A external.nixpkgs_20_03
- $ nix-build tests -A internal.nixpkgs_unstable
- ...
+ $ nix build .#hydraJobs.x86_64-linux.external-unstable -L
+
Contributing to the documentation
---------------------------------