Extend Setup Information

[?]
May 2, 2020, 1:31 PM
TK4KSKUKKWOZT5KASDRZH4HXKPW6WPCG3422LVKX6CK4RG43B6DQC

Dependencies

  • [2] KH55FNTF Update README
  • [*] NVMDS7GE Add README.md
  • [*] 5LVTBYXA README: fix manual links, fixes #401
  • [*] CLXEECMF * Start putting build results in a database.

Change contents

  • edit in README.md at line 35
    [2.1690]
    [5.0]
    ### Creating A Simple Project And Jobset
    In order to evaluate and build anything you need to crate _projects_ that contain _jobsets_. Hydra supports imperative and declarative projects and many different configurations. The steps below will guide you through the required steps to creating a minimal imperative project configuration.
    #### Creating A Project
    Log in as adminstrator, click "_Admin_" and select "_Create project_". Fill the form as follows:
    - **Identifier**: `hello`
    - **Display name**: `hello`
    - **Description**: `hello project`
    Click "_Create project_".
    #### Creating A Jobset
    After creating a project you are forwarded to the project page. Click "_Actions_" and choose "_Create jobset_". Fill the form with the following values:
    - **Identifier**: `hello`
    - **Nix expression**: `examples/hello.nix` in `hydra`
    - **Check interval**: 60
    - **Scheduling shares**: 1
    We have to add two inputs for this jobset. One for _nixpkgs_ and one for _hydra_ (which we are referrencing in the Nix expression above):
    - **Input name**: `nixpkgs`
    - **Type**: `Git checkout`
    - **Value**: `https://github.com/nixos/nixpkgs-channels nixos-20.03`
    - **Input name**: `hydra`
    - **Type**: `Git checkout`
    - **Value**: `https://github.com/nixos/hydra`
    Make sure **State** at the top of the page is set to "_Enabled_" and click on "_Create jobset_". This concludes the creation of a jobset that evaluates [./examples/hello.nix](./examples/hello.nix) once a minute. Clicking "_Evaluations_" should list the first evaluation of the newly created jobset after a brief delay.
  • file addition: examples (d--r------)
    [6.2]
  • file addition: hello.nix (----------)
    [0.1570]
    #
    # jobset example file. This file canbe referenced as Nix expression
    # in a jobset configuration along with inputs for nixpkgs and the
    # repository containing this file.
    #
    { ... }:
    let
    # <nixpkgs> is set to the value designated by the nixpkgs input of the
    # jobset configuration.
    pkgs = (import <nixpkgs> {});
    in {
    hello = pkgs.hello;
    }