Nixfiles, for hacc.
 
 
 
Go to file
stuebinm 35853d56e2 re-add infra4future.de faq
(contains info about how groups work)
2022-09-25 19:20:20 +02:00
common change name 2022-09-19 18:11:54 +02:00
desktop cleanup default apps 2021-12-30 22:30:17 +01:00
hosts remove gitlab 2022-09-24 17:29:42 +02:00
modules update and fix mattermost 2022-09-24 14:59:52 +00:00
nix update and fix mattermost 2022-09-24 14:59:52 +00:00
pkgs gitea: fix uffd login 2022-09-19 18:11:54 +02:00
services remove gitlab 2022-09-24 17:29:42 +02:00
websites re-add infra4future.de faq 2022-09-25 19:20:20 +02:00
.gitignore repo: add vim swapfiles to gitignore 2020-11-29 12:53:03 +00:00
.gitlab-ci.yml gitlab-ci.yml: disable nixda build 2022-02-27 12:22:30 +01:00
README.md update readme 2022-01-07 18:16:31 +01:00
default.nix sources: update nixpkgs to 21.05 2021-08-07 12:05:25 +00:00

README.md

hacc nixfiles

welcome to hacc nixfiles (haccfiles). this is the code describing our nix-based infrastructure.

structure

  • default.nix: Entrypoint to the config
  • common/: configuration common to all hosts
  • desktop/: desktop-relevant communication
  • modules/: home-grown modules for hacc-specific services
  • nix/: sources files, managed with niv
  • pkgs/: packages we built and don't want to upstream
  • hosts/: configuration.nix per host
  • services/: all services we run; imported in appropriate host config

working with the haccfiles

deploy:

nix build -f . deploy.$hostname && ./result switch

$hostname can be replaced with any hostname or group

I don't want to build this long dependency / want a cached version!

If it's still available on parsons from a previous deploy, do:

nix copy --from ssh://parsons /nix/store/...

Note: don't just copy the .drv file (which Nix complains about if it can't build something), that's just the description of how to build it! If you don't know the actual outpath, look in the .drv file (should start with Derive([("out","[the path you want]"...)

committing to haccfiles

  • Golden Rule: DO NOT COMMIT TO MAIN
    • exceptions apply, if you are not sure where to commit, don't commit to main
  • split up commits, every commit is one atomic change
    • e.g. no big "did some changes" but instead "updated service x", "updated service y", "update service z"
  • follow the commit format: "$prefix$place: $change"
    • prefix: one of fixup, nothing
    • place: one of "modules/$module", "$hostname/service", "common/($place)", "pkgs/$pkgs" or "sources"
    • change: describe your change, don't go over the character limit where git starts hiding/wrapping
  • Exception: autogenerated messages (merge commits, reverts, etc)