Skip to content
Snippets Groups Projects
Select Git revision
  • b551330352eede2934a80c3c47aa825b0434937e
  • develop default protected
  • production protected
  • nixpkgs-upgrade-2025-06-16
  • nixpkgs-upgrade-2024-12-23
  • 190-our-regular-updates-fill-up-the-servers-boot-partitions
  • nixpkgs-upgrade-2024-10-14
  • hro-cloud protected
  • 162.flexible-grafana-module
  • nixpkgs-upgrade-2024-05-13
  • nixpkgs-upgrade-2024-04-22
  • nixpkgs-upgrade-2024-03-25
  • nixpkgs-upgrade-2024-03-18
  • nixpkgs-upgrade-2024-03-11
  • nixpkgs-upgrade-2024-03-04
  • 163.jp-to-ben-for-prod
  • nixpkgs-upgrade-2024-02-26
  • 164.grafana-alert-rules
  • 157.authorize-new-hro-key
  • nixpkgs-upgrade-2024-02-19
  • nixpkgs-upgrade-2024-02-12
21 results

README.rst

Blame
  • README.rst 1.67 KiB

    Developer documentation

    Building

    The build system uses Nix which must be installed before anything can be built. Start by setting up the development/operations environment:

    $ nix-shell

    Testing

    The test system uses Nix which must be installed before any tests can be run.

    Unit tests are run using this command:

    $ nix-build nixos/unit-tests.nix

    Unit tests are also run on CI.

    The system tests are run using this command:

    $ nix-build nixos/system-tests.nix

    The system tests boot QEMU VMs which prevents them from running on CI at this time. The build requires > 10 GB of disk space, and the VMs might be timing out on slow or busy machines. If you run into timeouts, try raising the number of retries.

    It is also possible go through the testing script interactively - useful for debugging:

    $ nix-build -A private-storage.driver nixos/system-tests.nix

    This will give you a result symlink in the current directory. Inside that is bin/nixos-test-driver which gives you a kind of REPL for interacting with the VMs. The kind of Perl in this testScript is what you can enter into this REPL. Consult the official documentation on NixOS Tests for more information.

    Architecture overview