Hydra/de: Difference between revisions

From NixOS Wiki
leftover at
Tags: Mobile edit Mobile web edit
Jopejoe1 (talk | contribs)
No edit summary
 
(22 intermediate revisions by 3 users not shown)
Line 15: Line 15:
   services.hydra = {
   services.hydra = {
     enable = true;
     enable = true;
     hydraURL = "http://localhost:3000"; # extern sichtbare URL
     hydraURL = "http://localhost:3000"; # externally visible URL
     notificationSender = "hydra@localhost"; # E-Mail des Hydra-Services
     notificationSender = "hydra@localhost"; # e-mail of Hydra service
     # Bei einer eigenständigen Hydra muss die buildMachinesFiles-Liste deaktiviert werden, um zu vermeiden, dass ein nicht vorhandenes /etc/nix/machines verwendet wird.
     # a standalone Hydra will require you to unset the buildMachinesFiles list to avoid using a nonexistant /etc/nix/machines
     buildMachinesFiles = [];
     buildMachinesFiles = [];
     # Diese Option verhindert das *alles* von Grund auf neu gebaut
     # you will probably also want, otherwise *everything* will be built from scratch
     useSubstitutes = true;
     useSubstitutes = true;
   };
   };
Line 29: Line 29:
* Siehe <code>nixos-option</code> oder die  [https://search.nixos.org/options?query=services.hydra Nixos Optionsseite] für eine Liste aller Optionen.
* Siehe <code>nixos-option</code> oder die  [https://search.nixos.org/options?query=services.hydra Nixos Optionsseite] für eine Liste aller Optionen.


<span id="Web_Configuration"></span>
=== Webserverkonfiguration ===
=== Webserverkonfiguration ===
Hydra stellt ein Webinterface
 
[http://localhost:3000/ auf localhost] und Port 3000 bereit.
<div lang="en" dir="ltr" class="mw-content-ltr">
Allerdings muss ein neuer Admin-Account (als UNIX user <code>hydra</code>) erstellt werden, bevor man in der Lage ist Änderungen vorzunehmen:
Hydra will provide the web interface [http://localhost:3000/ at localhost] port 3000. However you need to create a new admin user (as UNIX user <code>hydra</code>) before being able to perform any changes:
</div>


<syntaxHighlight lang=bash>
<syntaxHighlight lang=bash>
Line 40: Line 42:
</syntaxHighlight>
</syntaxHighlight>


<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="Virtual_machine"></span>
=== Virtual machine ===
=== Virtuelle Maschinen ===
If not configured explicitly to do otherwise, Hydra will specify localhost as the default build machine. By default, system features enabling builds to be performed in virtual machines like "kvm" or "nixos-test" are not enabled. Such jobs will be queued indefinitely. Those options can be activated as follows:
 
Hydra benutzt localhost als Standardbuildmaschine,
wenn nichts anderes konfiguriert ist.
Standardmäßig sind die Systemfunktionen <code>kvm> und <code>nixos-test</code> in Nix,
zum benutzen von Virtuellen Maschinen nicht aktiviert. Jobs, die dies Funktionen benötigen werden daraufhin auf unbestimmte Zeit in die Warteschlange gestellt. Die folgenden Optionen aktieren diese Systemfeature:
 
<syntaxHighlight lang=nix>
<syntaxHighlight lang=nix>
{
{
Line 54: Line 61:
}
}
</syntaxHighlight>
</syntaxHighlight>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Diese Konfiguration erzeugt die Datei
This option leads to the file /etc/nix/machines being created. If the hydra service config is still set to buildMachinesFiles = [], then it will be ignored, so remove this option again or add <code>/etc/nix/machines</code> to it.
/etc/nix/machines.  
</div>
Falls die Hydra-option <code>buildMachinesFiles</code> immer noch auf eine leere Liste gesetzt ist, wird diese Einstellung ignoriert. Deswegen muss diese Option wieder entfernt werden oder <code>/etc/nix/machines</code> hinzugefügt werden.
 
<span id="Flake_jobset"></span>
== Flake-Jobset ==


<div lang="en" dir="ltr" class="mw-content-ltr">
Ein Jobset kann wie folgt konfiguriert werden.
== Flake jobset ==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
* Type: Flake
Configure jobset to the following:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
* Type: Flake
* Flake URI: an URI to a repo containing a Flake like git+https://git.myserver.net/user/repo.git
* Flake URI: an URI to a repo containing a Flake like git+https://git.myserver.net/user/repo.git
</div>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Der Flake-Output sollte das Attribut <code>hydraJobs</code> enthalten. <code>hydraJobs</code> ist ein Attributset, das verschachtelt sein kann und auf Derivations verweist.
The Flake output should have the attribute <code>hydraJobs</code> containing an attribute set that may be nested and reference derivations.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Ein Beispiel für ein Flake-Output, das Hydra veranlasst, alle Pakete zu bauen, könnte wie folgt aussehen:
A sample Flake output that makes Hydra build all packages could look like this:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<syntaxHighlight lang=nix>
<syntaxHighlight lang=nix>
{
{
Line 91: Line 90:
       ...
       ...
     };
     };
</div>


     <div lang="en" dir="ltr" class="mw-content-ltr">
     hydraJobs = {
hydraJobs = {
       inherit (self)
       inherit (self)
         packages;
         packages;
Line 101: Line 98:
}
}
</syntaxHighlight>
</syntaxHighlight>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="Restricted_Mode"></span>
=== Restricted Mode ===
=== Eingeschränkter Modus (Restricted mode) ===
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
Line 111: Line 106:
</div>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<syntaxHighlight lang=nix>
<syntaxHighlight lang=nix>
nix.settings.allowed-uris = [
nix.settings.allowed-uris = [
Line 119: Line 113:
];
];
</syntaxHighlight>
</syntaxHighlight>
<div lang="en" dir="ltr" class="mw-content-ltr">
== Build a single Package from nixpkgs ==
</div>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
== Build a single Package from nixpkgs ==
Right now it is not possible to build a single package from nixpkgs with just that input. You will need to provide a supplementary repository which defines what to build. For examples you can check the [https://github.com/makefu/hydra-example hydra-example by makefu] and in the [https://nixos.org/hydra/manual/#idm140737315920320 Hydra Manual].
Right now it is not possible to build a single package from nixpkgs with just that input. You will need to provide a supplementary repository which defines what to build. For examples you can check the [https://github.com/makefu/hydra-example hydra-example by makefu] and in the [https://nixos.org/hydra/manual/#idm140737315920320 Hydra Manual].
</div>
</div>
Line 128: Line 124:
<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
=== Imperative Building ===
=== Imperative Building ===
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
These steps are required to build the <code>hello</code> package.
These steps are required to build the <code>hello</code> package.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
# log into Hydra after creating a user with <code>hydra-create-user</code>
# log into Hydra after creating a user with <code>hydra-create-user</code>
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
# create new project
# create new project
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* identifier: example-hello
* identifier: example-hello
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* display name: example-hello
* display name: example-hello
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
# Actions -> Create jobset
# Actions -> Create jobset
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* identifier: hello
* identifier: hello
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* Nix expression: <code>release.nix</code> in <code>hydra-example</code> -> will evaluate the file release.nix in the given input
* Nix expression: <code>release.nix</code> in <code>hydra-example</code> -> will evaluate the file release.nix in the given input
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* check interval: 60
* check interval: 60
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* scheduling shares: 1
* scheduling shares: 1
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* Inputs:
* Inputs:
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
{| class="wikitable"
{| class="wikitable"
|-
|-
Line 155: Line 187:
<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
=== Declarative Building ===
=== Declarative Building ===
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
Since 2016, Hydra supports declarative creation of jobsets. Check out the [https://github.com/shlevy/declarative-hydra-example example repository and description by Shea Levy].
Since 2016, Hydra supports declarative creation of jobsets. Check out the [https://github.com/shlevy/declarative-hydra-example example repository and description by Shea Levy].
</div>
</div>
Line 160: Line 195:
<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
== Hydra Internals ==
== Hydra Internals ==
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
=== Definitions ===
=== Definitions ===
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
==== Project ====  
==== Project ====
</div>
 
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>
</div>


<div class="mw-translate-fuzzy">
<span id="Jobsets"></span>
==== Jobset ====
==== Jobset ====
Eine Liste von Jobs, die ausgeführt werden sollen. Oft passt ein Jobset zu einem bestimmten Branch (master, staging, stable). Ein Jobset wird durch seine Eingaben definiert und wird ausgelöst, wenn sich diese Eingaben ändern, z.B. wenn ein neuer Commit zu einem Branch hinzugefügt wird. Jobsets können voneinander abhängen
</div>


<div class="mw-translate-fuzzy">
Eine Liste von Jobs, die ausgeführt werden sollen. Oft passt ein Jobset zu einem bestimmten Branch (master, staging, stable). Ein Jobset wird durch seine Eingaben definiert und wird ausgelöst, wenn sich diese Eingaben ändern, z.B. wenn ein neuer Commit zu einem Branch hinzugefügt wird. Jobsets können voneinander abhängen.
 
==== Job ====
==== Job ====
Ein Closure, welches als Teil eines Jobsatzes erstellt wird (wie ein einzelnes Paket, ISO-Image oder Tarball)
 
</div>
Ein Closure, welches als Teil eines Jobsatzes erstellt wird (wie ein einzelnes Paket, ISO-Image oder Tarball).


==== Release Set ====
==== Release Set ====
Definiert alle Jobs, die in Ihrem Release beschrieben sind. Konventionell wird eine Datei namens <code>release.nix</code> verwendet. Eine ausführliche Beschreibung der Struktur finden Sie im [https://nixos.org/hydra/manual/#idm140737315920320 Hydra Handbuch für Build Recipes].
Definiert alle Jobs, die in Ihrem Release beschrieben sind. Konventionell wird eine Datei namens <code>release.nix</code> verwendet. Eine ausführliche Beschreibung der Struktur finden Sie im [https://nixos.org/hydra/manual/#idm140737315920320 Hydra Handbuch für Build Recipes].


<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
==== Evaluation ====
==== Evaluation ====
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
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>.
</div>
</div>
Line 189: Line 236:
<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
==== Build ====
==== Build ====
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
Instantiation of a Job which is being triggered by being part of the release set.
Instantiation of a Job which is being triggered by being part of the release set.
</div>
</div>
Line 194: Line 244:
<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
== Known Issues ==
== Known Issues ==
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* hydra-queue-runner sometimes gets stuck even with builds are in the queue, and the builds are not scheduled. The issue is being tracked [https://github.com/NixOS/hydra/issues/366 here]. In the meantime, a workaround is to add a cron job that regularly restarts the hydra-queue-runner systemd service. Possible fix: [https://github.com/NixOS/hydra/commit/73ca325d1c0f7914640a63764c9a6d448fde5bd0]
* hydra-queue-runner sometimes gets stuck even with builds are in the queue, and the builds are not scheduled. The issue is being tracked [https://github.com/NixOS/hydra/issues/366 here]. In the meantime, a workaround is to add a cron job that regularly restarts the hydra-queue-runner systemd service. Possible fix: [https://github.com/NixOS/hydra/commit/73ca325d1c0f7914640a63764c9a6d448fde5bd0]
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* If you see <code>error: unexpected end-of-file</code> it can mean multiple things, some of them are:
* If you see <code>error: unexpected end-of-file</code> it can mean multiple things, some of them are:
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
# You have a miss-match between nix versions on the Hydra server and the builder
# You have a miss-match between nix versions on the Hydra server and the builder
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
# It can also mean that <code>hydra-queue-runner</code> needs privileges on the build server. Reference: [https://github.com/NixOS/nix/issues/2789]
# It can also mean that <code>hydra-queue-runner</code> needs privileges on the build server. Reference: [https://github.com/NixOS/nix/issues/2789]
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* The default timeout for git operations is 600 seconds [https://github.com/NixOS/hydra/issues/1181], which might cause fetches of large repositories like [https://github.com/NixOS/nixpkgs nixos/nixpkgs] to fail: <code>error fetching latest change from git repo at `https://github.com/nixos/nixpkgs': timeout</code>. The timeout can be increased with the following configuration.nix snippet:
* The default timeout for git operations is 600 seconds [https://github.com/NixOS/hydra/issues/1181], which might cause fetches of large repositories like [https://github.com/NixOS/nixpkgs nixos/nixpkgs] to fail: <code>error fetching latest change from git repo at `https://github.com/nixos/nixpkgs': timeout</code>. The timeout can be increased with the following configuration.nix snippet:
</div>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<syntaxHighlight lang=nix>
<syntaxHighlight lang=nix>
{
{
Line 211: Line 275:
}
}
</syntaxHighlight>
</syntaxHighlight>
<div lang="en" dir="ltr" class="mw-content-ltr">
== Hydra for NixOS releases ==
</div>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
== Hydra for NixOS releases ==
Hydra is used for managing official Nix project releases. The project Hydra server: https://hydra.nixos.org/
Hydra is used for managing official Nix project releases. The project Hydra server: https://hydra.nixos.org/
</div>
</div>
Line 220: Line 286:
<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
Some Hydra trackers for Nix projects:
Some Hydra trackers for Nix projects:
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* [https://hydra.nixos.org/project/nixpkgs Nixpkgs]
* [https://hydra.nixos.org/project/nixpkgs Nixpkgs]
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* [https://hydra.nixos.org/project/nixos NixOS]
* [https://hydra.nixos.org/project/nixos NixOS]
</div>
</div>
Line 226: Line 298:
<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
== Resources ==
== Resources ==
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* [https://www.youtube.com/watch?v=RXV0Y5Bn-QQ Video: Setting up a Hydra Build Farm by Peter Simons (2016)]
* [https://www.youtube.com/watch?v=RXV0Y5Bn-QQ Video: Setting up a Hydra Build Farm by Peter Simons (2016)]
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* [https://gist.github.com/joepie91/c26f01a787af87a96f967219234a8723 Hydra Caveats by Joepie91]
* [https://gist.github.com/joepie91/c26f01a787af87a96f967219234a8723 Hydra Caveats by Joepie91]
</div>
</div>

Latest revision as of 12:55, 30 July 2024

Hydra ist ein Werkzeug für kontinuierliche Integrationstests und Softwarefreigabe, das eine rein funktionale Sprache zur Beschreibung von Build-Jobs und deren Abhängigkeiten verwendet. Kontinuierliche Integration ist eine einfache Technik zur Verbesserung der Qualität des Softwareentwicklungsprozesses. Ein automatisiertes System prüft kontinuierlich oder periodisch den Quellcode eines Projekts, baut ihn, führt Tests durch und erstellt Berichte für die Entwickler. Auf diese Weise werden verschiedene Fehler, die versehentlich in die Codebasis aufgenommen werden könnten, automatisch erkannt.

Die offiziellen Hydra-Server bieten vorgefertigte Binärpakete an, um die Aktualisierungszeit für Nixpgs zu verkürzen: Die Benutzer müssen sie nicht auf ihren eigenen Computern kompilieren.

Das Hydra Handbuch bietet eine Übersicht der Funktionalität und Funktionen von Hydra sowohl als auch eine aktuelle Installationsanleitung.

Installation

Eine vollständige Installation kann wie folgt konfiguriert werden:

  services.hydra = {
    enable = true;
    hydraURL = "http://localhost:3000"; # externally visible URL
    notificationSender = "hydra@localhost"; # e-mail of Hydra service
    # a standalone Hydra will require you to unset the buildMachinesFiles list to avoid using a nonexistant /etc/nix/machines
    buildMachinesFiles = [];
    # you will probably also want, otherwise *everything* will be built from scratch
    useSubstitutes = true;
  };

Dieses Modul aktiviert PostgreSQL automatisch, außer die services.hydra.dbi wird geändert. Das Datenbanklayout wird automatisch erstellt vom Hydra-Service. Allerdings ist anzumerken, das zusätzliche Daten in der Datenbank gespeichert werden, was eine vollständige deklarative Konfiguration unmöglich macht. Daher sind Backups erforderlich.

Webserverkonfiguration

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:

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

Virtuelle Maschinen

Hydra benutzt localhost als Standardbuildmaschine, wenn nichts anderes konfiguriert ist. Standardmäßig sind die Systemfunktionen kvm> und nixos-test in Nix, zum benutzen von Virtuellen Maschinen nicht aktiviert. Jobs, die dies Funktionen benötigen werden daraufhin auf unbestimmte Zeit in die Warteschlange gestellt. Die folgenden Optionen aktieren diese Systemfeature:

{
  nix.buildMachines = [
    { hostName = "localhost";
      system = "x86_64-linux";
      supportedFeatures = ["kvm" "nixos-test" "big-parallel" "benchmark"];
      maxJobs = 8;
    }
  ];
}

Diese Konfiguration erzeugt die Datei /etc/nix/machines. Falls die Hydra-option buildMachinesFiles immer noch auf eine leere Liste gesetzt ist, wird diese Einstellung ignoriert. Deswegen muss diese Option wieder entfernt werden oder /etc/nix/machines hinzugefügt werden.

Flake-Jobset

Ein Jobset kann wie folgt konfiguriert werden.

  • Type: Flake

Der Flake-Output sollte das Attribut hydraJobs enthalten. hydraJobs ist ein Attributset, das verschachtelt sein kann und auf Derivations verweist.

Ein Beispiel für ein Flake-Output, das Hydra veranlasst, alle Pakete zu bauen, könnte wie folgt aussehen:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
  };
  outputs = { self, nixpkgs, ... }: {
    packages.x86_64-linux = {
      ...
    };

    hydraJobs = {
      inherit (self)
        packages;
    };
  };
}

Eingeschränkter Modus (Restricted mode)

Hydra evaluates flakes in restricted mode. This prevents access to files outside of the nix store, including those fetched as flake inputs. Update your nix.settings.allowed-uris to include URI prefixes from which you expect flake inputs to be fetched:

nix.settings.allowed-uris = [
  "github:"
  "git+https://github.com/"
  "git+ssh://github.com/"
];

Build a single Package from nixpkgs

Right now it is not possible to build a single package from nixpkgs with just that input. You will need to provide a supplementary repository which defines what to build. For examples you can check the hydra-example by makefu and in the Hydra Manual.

Imperative Building

These steps are required to build the hello package.

  1. log into Hydra after creating a user with hydra-create-user
  1. create new project
  • identifier: example-hello
  • display name: example-hello
  1. Actions -> Create jobset
  • identifier: hello
  • Nix expression: release.nix in hydra-example -> will evaluate the file release.nix in the given input
  • check interval: 60
  • scheduling shares: 1
  • Inputs:
Input Name Type Value Note
nixpkgs git checkout https://github.com/nixos/nixpkgs nixos-21.11 will check out branch nixos-21.11, will be made available to the nix expression via <nixpkgs>.
hydra-example git checkout https://github.com/makefu/hydra-example hydra-example is used by the jobset as input, release.nix is in the root directory

After creation, the jobset should be in the evaluation phase where inputs will be fetched. This phase may take some time as the complete nixpkgs repository needs to be downloaded before continuing. The result of the evaluation should be a single job which will get built.

Declarative Building

Since 2016, Hydra supports declarative creation of jobsets. Check out the example repository and description by Shea Levy.

Hydra 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. Every Job should be able to be built independently from another. Most of the time the project maps to a single repository like nixpkgs. It is comparable to the project definition in Jenkins.

Jobset

Eine Liste von Jobs, die ausgeführt werden sollen. Oft passt ein Jobset zu einem bestimmten Branch (master, staging, stable). Ein Jobset wird durch seine Eingaben definiert und wird ausgelöst, wenn sich diese Eingaben ändern, z.B. wenn ein neuer Commit zu einem Branch hinzugefügt wird. Jobsets können voneinander abhängen.

Job

Ein Closure, welches als Teil eines Jobsatzes erstellt wird (wie ein einzelnes Paket, ISO-Image oder Tarball).

Release Set

Definiert alle Jobs, die in Ihrem Release beschrieben sind. Konventionell wird eine Datei namens release.nix verwendet. Eine ausführliche Beschreibung der Struktur finden Sie im Hydra Handbuch für Build Recipes.

Evaluation

The process of interpreting nix code into a list of .drv files. These files are the build recipes for all related outputs. You can introspect these files by running nix show-derivation nixpkgs.hello.

Build

Instantiation of a Job which is being triggered by being part of the release set.

Known Issues

  • hydra-queue-runner sometimes gets stuck even with builds are in the queue, and the builds are not scheduled. The issue is being tracked here. In the meantime, a workaround is to add a cron job that regularly restarts the hydra-queue-runner systemd service. Possible fix: [1]
  • If you see error: unexpected end-of-file it can mean multiple things, some of them are:
  1. You have a miss-match between nix versions on the Hydra server and the builder
  1. It can also mean that hydra-queue-runner needs privileges on the build server. Reference: [2]
  • The default timeout for git operations is 600 seconds [3], which might cause fetches of large repositories like nixos/nixpkgs to fail: error fetching latest change from git repo at `https://github.com/nixos/nixpkgs': timeout. The timeout can be increased with the following configuration.nix snippet:
{
  services.hydra.extraConfig = ''
    <git-input>
      timeout = 3600
    </git-input>
  '';
}

Hydra for NixOS releases

Hydra is used for managing official Nix project releases. The project Hydra server: https://hydra.nixos.org/

Some Hydra trackers for Nix projects:

Resources