Hydra: Difference between revisions

imported>Garbas
mNo edit summary
imported>Plutotulp
m Change formatting of definitions from list items to minor headings. The list version would render as ugly boxes of verbatim text, with scroll bars in them.
Line 77: Line 77:
This subsection provides an overview of the Hydra-specific definitions and how to configure them.
This subsection provides an overview of the Hydra-specific definitions and how to configure them.


* Project:
==== 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. Every Job should be able to be built independently from another. Most of the time the project maps to a single repository like <code>nixpkgs</code>. It is comparable to the project definition in Jenkins
A cluster of Jobs which are all coming from a single input (like a git checkout), the first thing you will need to create. Every Job should be able to be built independently from another. Most of the time the project maps to a single repository like <code>nixpkgs</code>. It is comparable to the project definition in Jenkins
* Job Set:
 
  A list of jobs which will be run. Often a Jobset fits to a certain branch (master, staging, stable). A jobset is defined by its inputs and will trigger if these inputs change, e.g. like a new commit onto a branch is added. Job sets may depend on each other
==== Job Set ====
* Job:
A list of jobs which will be run. Often a Jobset fits to a certain branch (master, staging, stable). A jobset is defined by its inputs and will trigger if these inputs change, e.g. like a new commit onto a branch is added. Job sets may depend on each other
  A closure which will be built as part of a jobset (like a single package, iso image or tarball)
 
* Release Set:
==== Job ====
  Defines all the jobs which are described in your release. By convention a file called<code>release.nix</code> is being used. See the [https://nixos.org/hydra/manual/#idm140737315920320 Hydra manual for Build Recipes] for a thorough description of the structure.
A closure which will be built as part of a jobset (like a single package, iso image or tarball)
* Evaluation:
 
  The process of interpreting nix code into a list of <code>.drv files</code>. These files are the build recipes for all related outputs. You can introspect these files by running <code>nix show-derivation nixpkgs.hello</code>
==== Release Set ====
* Build:
Defines all the jobs which are described in your release. By convention a file called<code>release.nix</code> is being used. See the [https://nixos.org/hydra/manual/#idm140737315920320 Hydra manual for Build Recipes] for a thorough description of the structure.
  Instantiation of a Job which is being triggered by being part of the release set
 
==== Evaluation ====
The process of interpreting nix code into a list of <code>.drv files</code>. These files are the build recipes for all related outputs. You can introspect these files by running <code>nix show-derivation nixpkgs.hello</code>
 
==== Build ====
Instantiation of a Job which is being triggered by being part of the release set


== Known Issues ==
== Known Issues ==