Non-NixOS Hydra installation [needs better documentation]
Nobody has claimed this yet.
- Dominant language
- PLpgSQL
- Stars
- 1.6k
- Forks
- 358
- Avg merge
- 20h 30m
- Merged PRs (30d)
- 27
Description
Hi,
I thought I'd document my experience installing Hydra on a non-NixOS system (Ubuntu 18.04.3):
- I did the multi-user install, it went seemingly fine (under my user)
- manual still has the adding the channel, I only needed to run
nix-env -i hydra(under my user) - manual has something about "Note $prefix ..." but "$prefix" isn't mentioned anywhere else
- manual isn't clear on the
createuserandcreatedbsteps (I know nothing about PostgreSQL and very little about SQL in general), got a colleague to do that for me, turns out they needed to be run under thepostgresuser - From this point onwards, everything else is done under the
hydrauser I added for it - I needed to do https://github.com/NixOS/hydra/issues/584
- For some reason I needed to do
systemctl start nix-daemon.service, not sure if this is because something I have done wrong during the installation, I did trysystemctl enable nix-daemon.servicebut it doesn't seem to work. This is probably something broken with my Ubuntu? [edit: actually, it is possibly because I have/nixas a mount, and systemd thinks the filenix-daemon.service, a symlink to/nix/var/nix/profiles/default/lib/systemd/system/nix-daemon.serviceis broken] - manual only mentions
hydra-server,hydra-evaluator, andhydra-queue-runner. For declarative jobs, I needed to starthydra-notify. There is also hydra-send-stats which always seems to die, on my NixOS declaratively defined hydra too (Died at /nix/store/zhbxmfmp8w0b8kgl831pm9970is8lnja-hydra-2019-08-30/bin/.hydra-send-stats-wrapped line 14)
This is related to improving hydra documentation https://github.com/NixOS/hydra/issues/210 but I decided to make it a new issue to make it easier to find.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Hydra manual linked in the issue and compare its non-NixOS installation section with the reported Ubuntu 18.04.3 steps. Review the PostgreSQL createuser/createdb instructions, nix-daemon startup, and required Hydra services including hydra-notify and hydra-send-stats. Done means the manual clearly documents the necessary non-NixOS setup and service commands.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- linux, postgresql, ubuntu
- Domain
- databases, devops, documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100