Hydra: Difference between revisions

From NixOS Wiki
imported>Makefu
No edit summary
imported>Makefu
No edit summary
Line 16: Line 16:
     hydraURL = "http://localhost:3000"; # externally visible URL
     hydraURL = "http://localhost:3000"; # externally visible URL
     hydraSender = "hydra@localhost"; # e-mail of hydra service
     hydraSender = "hydra@localhost"; # e-mail of hydra service
    # you will probably also want, otherwise *everything* will be built from scratch
    # useSubstitutes = true
   };
   };
</syntaxHighlight>
</syntaxHighlight>

Revision as of 01:20, 28 December 2017

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
    # you will probably also want, otherwise *everything* will be built from scratch
    # useSubstitutes = true
  };

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.

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