NixOS / NixOS/hydra

Non-NixOS Hydra installation [needs better documentation]

Open
#682 3 comments 4 reactions 0 assignees View on GitHub

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 createuser and createdb steps (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 the postgres user
  • From this point onwards, everything else is done under the hydra user 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 try systemctl enable nix-daemon.service but it doesn't seem to work. This is probably something broken with my Ubuntu? [edit: actually, it is possibly because I have /nix as a mount, and systemd thinks the file nix-daemon.service, a symlink to /nix/var/nix/profiles/default/lib/systemd/system/nix-daemon.service is broken]
  • manual only mentions hydra-server, hydra-evaluator, and hydra-queue-runner. For declarative jobs, I needed to start hydra-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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.