hacc/haccfiles
8
0
Fork 1
Code Issues 1 Pull requests Projects Releases Wiki Activity
Wie Sie sehen, sehen sie nix! https://docs.hacc.space
308 commits 11 branches 0 tags 21 MiB
SCSS 40.3%
HTML 28.6%
Nix 28%
Scheme 1.5%
Shell 0.9%
Other 0.7%
Find a file
stuebinm a70da63d61
use the voc's fork of obs 
notes:
 - doesn't use niv to manage its sources, since apparently niv doesn't
   support git submodules
 - haven't tested that this actually builds (it does build without the
   blackmagic stuff, which I don't have locally and didn't have the
   patience to fetch)
2021-12-22 14:24:44 +01:00
common set timezones 2021-09-19 16:35:38 +02:00
desktop set timezones 2021-09-19 16:35:38 +02:00
hosts nixda: disable companion 2021-12-19 17:21:43 +01:00
modules modules/nextcloud: add option for defaultapp 2021-10-31 08:27:40 +01:00
nix sources: add 21.11 as nixpkgs-new 2021-12-11 13:20:15 +01:00
pkgs use the voc's fork of obs 2021-12-22 14:24:44 +01:00
services services/lantifa: set mediawiki-version from 21.11 2021-12-11 13:20:42 +01:00
.gitignore repo: add vim swapfiles to gitignore 2020-11-29 12:53:03 +00:00
.gitlab-ci.yml services/gitlab-runner: init on parsons 2021-08-23 19:32:02 +00:00
default.nix sources: update nixpkgs to 21.05 2021-08-07 12:05:25 +00:00
README.md readme: add golden commit rule 2021-01-20 18:47:57 +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

working with the haccfiles

deploy:

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

$hostname can be replaced with any hostname or group

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)