nixfleet/README.org

71 lines
2.2 KiB
Org Mode

* NixFleet
A complete, declarative and reproducible configuration of my entire
Nix fleet, this includes the following machines:
- [X] my main home workstation ~pc~
- [X] homeserver (mainly a nas) ~hs~
- [X] my arm based [[https://wiki.pine64.org/wiki/Pinebook_Pro][PineBook Pro]] ~pbp~, almost completely open hardware
- [X] MacBook PRO that I use for work, for this I'll use [[https://github.com/LnL7/nix-darwin][nix-darwin]] keeping macOs 11 Monterey.
The different confgurations share many profiles, in fact my original
goal was to avoid to rewrite the same Nix derivations for my
different machines.
** Commands
Here I describe my most used commands. All the commands are executed
inside the Flake's development shell. To enter in this shell is
sufficent to ~cd~ in the folder (if you use ~direnv~) or run ~nix
develop~.
*** Checking
To check that the Nix Flake is [[https://nixos.org/manual/nix/unstable/command-ref/new-cli/nix3-flake-check.html#evaluation-checks][well defined]]:
#+begin_src shell
nix flake check
#+end_src
*** Building
#+begin_src shell
nix -Lv build
".#nixosConfigurations.<host>.config.system.build.toplevel"
#+end_src
where ~<host>~ is the hostname e.g. ~pc~.
*** Testing new config
#+begin_src shell
bud rebuild <host> test
#+end_src
where ~<host>~ is the hostname e.g. ~pc~.
*** Switching
#+begin_src shell
bud rebuild <host> switch
#+end_src
where ~<host>~ is the hostname e.g. ~pc~.
*** Remote deploy
#+begin_src shell
deploy -d --hostname <hostname> '.#<host>' --skip-checks --ssh-user root
#+end_src
where
- ~<hostname>~ is the remote machine hostname or ip
- ~<host>~ is one between ~pc~, ~pbp~ or ~hs~
** Github Actions
*** Check and build
At every commit pushed on ~master~ a Github actions which ~nix flake
check~ the flake is executed and then every system is build.
Currently this workflow will skip ~aarch64~ hosts since the runner is
~x86_64~ and I didn't find a way to make it cross compile.
*** Release
At every tagged commit whose tag name starts with ~release-~ a process
that releases all the bootstrap ISOs for the systems is started. Here
I've the same problem with ~aarch64~ hosts so the runner will skip
them.