diff options
author | Bobby Rong <rjl931189261@126.com> | 2021-07-02 20:23:38 +0800 |
---|---|---|
committer | Bobby Rong <rjl931189261@126.com> | 2021-07-02 20:23:38 +0800 |
commit | 8fafcfa3ea8730b9e265fd0d4f605fd86897b116 (patch) | |
tree | 0438c3a07fe3a2fd97b00d4054a3ebf992081c93 /nixos/doc/manual/development/running-nixos-tests.section.md | |
parent | 163976c296a3ba07680b524855b1762c77a15249 (diff) | |
download | nixpkgs-8fafcfa3ea8730b9e265fd0d4f605fd86897b116.tar nixpkgs-8fafcfa3ea8730b9e265fd0d4f605fd86897b116.tar.gz nixpkgs-8fafcfa3ea8730b9e265fd0d4f605fd86897b116.tar.bz2 nixpkgs-8fafcfa3ea8730b9e265fd0d4f605fd86897b116.tar.lz nixpkgs-8fafcfa3ea8730b9e265fd0d4f605fd86897b116.tar.xz nixpkgs-8fafcfa3ea8730b9e265fd0d4f605fd86897b116.tar.zst nixpkgs-8fafcfa3ea8730b9e265fd0d4f605fd86897b116.zip |
nixos: nixos/doc/manual/development/running-nixos-tests.xml to CommonMark
Diffstat (limited to 'nixos/doc/manual/development/running-nixos-tests.section.md')
-rw-r--r-- | nixos/doc/manual/development/running-nixos-tests.section.md | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/nixos/doc/manual/development/running-nixos-tests.section.md b/nixos/doc/manual/development/running-nixos-tests.section.md new file mode 100644 index 00000000000..d6a456f0188 --- /dev/null +++ b/nixos/doc/manual/development/running-nixos-tests.section.md @@ -0,0 +1,31 @@ +# Running Tests {#sec-running-nixos-tests} + +You can run tests using `nix-build`. For example, to run the test +[`login.nix`](https://github.com/NixOS/nixpkgs/blob/master/nixos/tests/login.nix), +you just do: + +```ShellSession +$ nix-build '<nixpkgs/nixos/tests/login.nix>' +``` + +or, if you don't want to rely on `NIX_PATH`: + +```ShellSession +$ cd /my/nixpkgs/nixos/tests +$ nix-build login.nix +… +running the VM test script +machine: QEMU running (pid 8841) +… +6 out of 6 tests succeeded +``` + +After building/downloading all required dependencies, this will perform +a build that starts a QEMU/KVM virtual machine containing a NixOS +system. The virtual machine mounts the Nix store of the host; this makes +VM creation very fast, as no disk image needs to be created. Afterwards, +you can view a pretty-printed log of the test: + +```ShellSession +$ firefox result/log.html +``` |