robur/builder-web
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A web user interface and API for our reproducible builds of MirageOS unikernels and host system tools.
197 commits 8 branches 2 tags 6.5 MiB
OCaml 92.3%
Shell 7.7%
Find a file
Reynir Björnsson 675b57a579 Rename Builder_db modules in bin/ and test/ 
They both depend on the Builder_db module in db/, and using the same
name confuses Merlin (as well as myself sometimes).
2021-11-15 15:12:16 +01:00
auth add explicit package dependencies 2021-06-09 16:03:03 +00:00
bin Rename Builder_db modules in bin/ and test/ 2021-11-15 15:12:16 +01:00
db Show builds by platform 2021-11-08 15:03:19 +00:00
http_status_middleware Add http status metrics middleware 2021-06-08 12:36:53 +00:00
lib improve comparison page and always link with current build as head (right_build) 2021-11-12 13:01:20 +00:00
opamdiff investigate differences in build, install, and uri when opam file differed (#48) 2021-07-06 08:34:17 +00:00
packaging debian postinst: fix user/group mixup 2021-11-14 13:47:51 +01:00
test Rename Builder_db modules in bin/ and test/ 2021-11-15 15:12:16 +01:00
.gitignore avoid deprecated functions from Fmt (strf is now str) 2021-10-18 13:22:07 +00:00
builder-web.opam opam: require metrics 0.3.0 and above 2021-11-12 14:31:42 +00:00
CHANGES.md Prepare for initial public release 2021-11-12 13:42:26 +00:00
dune-project Initial commit 2020-12-04 18:10:21 +01:00
LICENSE.md debian packaging 2021-06-29 09:41:05 +00:00
README.md Prepare for initial public release 2021-11-12 13:42:26 +00:00

README.md

Builder-web - a web frontend for reproducible builds

Builder-web takes in submissions of builds, typically from builder, and displays the produced artifacts in a way that makes it easy to compare checksums and build status. Produced binaries can be downloaded and executed. builds.robur.coop itself runs builder-web.

Overview

Builder-web is a single binary web server using a sqlite3 database with versioned schemas. Finished builds from builder are uploaded to builder-web, stored and indexed in the database and presented in the web interface to the user. Users can:

  • Get an overview of jobs - a job is typically script or opam package that is run and builds an artifact,
  • Browse all builds of a job - each job may have multiple builds, that are executed periodically by builder
  • Browse individual build and download artifacts and build information for reproducing the same binary.
  • Compare two builds, observing the differences in used opam packages, environment variables, and system packages.
  • Search for the SHA-256 hash of a binary to view a build that resulted in that binary.

Installation

Installing from source can be done with opam: opam install builder-web.

We also provide reproducible binary packages.

Setup

Builder-web consists of a binary builder-web that runs a web server on port 3000 listening on all interfaces by default. These values can be changed with the --port and --host flags respectively. See builder-web --help for more information.

Service scripts for FreeBSD and systemd are provided.

The web server expects a sqlite3 database in its data directory. An empty database can be created with builder-db migrate.

Database migrations

The sqlite3 database builder-web uses contains versioning information. On every schema change the database schema version is updated, and migration and rollback scripts are provided. The tool for database migrations is builder-migrations. See the builder-migrations --help output for each migration for further details.