NotAShelf
ea94adb6d1
Signed-off-by: NotAShelf <raf@notashelf.dev> Change-Id: I8baf9c2c307b96a5668e19fb11d5e83b6a6a6964
48 lines
1.8 KiB
Markdown
48 lines
1.8 KiB
Markdown
# Design
|
|
|
|
Notes to self and somewhat of a guide to design some of the design choices
|
|
behind FC. This is not a contribution guideline, and changes to this document
|
|
are welcome if necessary.
|
|
|
|
## Overview
|
|
|
|
FC is built as a local replacement for Hydra. Meaning you probably do not want
|
|
to deploy it on your Super Enterprise Friends Group that needs a reliable CI.
|
|
This project is an attempt to utilize our infrastructure members as build
|
|
machines to cache our projects without relying on Github's weak runners.
|
|
|
|
---
|
|
|
|
Hydra is the Nix/NixOS project's continuous integration system. It uses Nix to
|
|
declaratively define and build jobs, ensuring reproducible builds. According to
|
|
the NixOS Wiki:
|
|
|
|
> "Hydra is a tool for continuous integration testing and software release that
|
|
> uses a purely functional language to describe build jobs and their
|
|
> dependencies."
|
|
|
|
In Hydra:
|
|
|
|
- A **Project** corresponds to a source repository.
|
|
- A **Jobset** (often per branch or channel) contains many **Jobs** (Nix
|
|
derivations to build).
|
|
- A `release.nix` ("Release Set") file declares what to build.
|
|
|
|
Hydra pulls changes from version control, re-evaluates Nix expressions, and
|
|
triggers builds when inputs change.
|
|
|
|
FC _more or less_ commits to this design, with minimal tweaks for modernity and
|
|
UX. Most critically, FC is not designed to be used alongside Nixpkgs. Indeed,
|
|
you _could_ do it and I am more than willing to try and support this use case
|
|
but it is far from the main goal. The primary purpose of FC is to be a
|
|
distributed, declarative CI that **has learned from Hydra's mistakes**.
|
|
|
|
## On Hydra
|
|
|
|
### Component Interactions and Data Flow
|
|
|
|
Hydra follows a tightly-coupled architecture with three main daemons:
|
|
|
|
```plaintext
|
|
Git Repository -> Evaluator -> Database -> Queue Runner -> Build Hosts -> Results -> Database - Web UI
|
|
```
|