Hydra

This article or section needs expansion.

Reason: This article is a stub. (Discuss in Talk:Hydra#)
Please consult the pedia article metapage for guidelines on contributing.

Hydra is a tool for continuous integration testing and software release that uses a purely functional language to describe build jobs and their dependencies. Continuous integration is a simple technique to improve the quality of the software development process. An automated system continuously or periodically checks out the source code of a project, builds it, runs tests, and produces reports for the developers. Thus, various errors that might accidentally be committed into the code base are automatically caught.

From the Hydra manual

The Hydra manual provides an overview of the functionality and features of hydra, as well as an up-to-date installation guide.

Usage

Installation

Since 2017, hydra is available as a NixOS module and therefore a full deployment can be enabled as easy as

  services.postgresql.enable = true; 
  services.hydra = {
    enable = true;
    hydraURL = "http://localhost:3000"; # externally visible URL
    hydraSender = "hydra@localhost"; # e-mail of hydra service
  };

Database layout will be created automatically by the hydra service, however keep in mind that some state will be stored in the database and a complete stateless configuration is currently not possible - do your backups.

See nixos-option or the Nixos Options page for all options

Web Config

Hydra will provide the web interface at localhost port 3000. However you need to create a new admin user (as unix user hydra) before being able to perform any changes:

$ hydra-create-user alice --full-name 'Alice Q. User' \
    --email-address 'alice@example.org' --password foobar --role admin

Build a single Package from nixpkgs

TODO

Internals

Definitions

This subsection provides an overview of the Hydra-specific definitions and how to configure them.

Project: A cluster of Jobs which are all coming from a single input (like a git checkout), the first thing you will need to create.
Job Set:
Release Set: TODO
Build Job: TODO
Build Recipes:TODO

Resources