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.
176 commits 8 branches 2 tags 6.5 MiB
OCaml 92.3%
Shell 7.7%
Find a file
Robur 579f9d38e6 debian packaging: install meta files and systemd script with 644 permissions
2021-11-02 10:28:47 +00:00
auth add explicit package dependencies 2021-06-09 16:03:03 +00:00
bin verify-data-dir: change level for untracked files 2021-09-14 16:03:12 +02:00
db Fix broken query remove_all_by_username 2021-10-26 13:22:31 +02:00
http_status_middleware Add http status metrics middleware 2021-06-08 12:36:53 +00:00
lib upload_binary: add binary_name query parameter 2021-10-26 13:24:17 +02:00
opamdiff investigate differences in build, install, and uri when opam file differed (#48) 2021-07-06 08:34:17 +00:00
packaging debian packaging: install meta files and systemd script with 644 permissions 2021-11-02 10:28:47 +00:00
test WIP 2021-09-07 09:35:26 +00:00
.gitignore avoid deprecated functions from Fmt (strf is now str) 2021-10-18 13:22:07 +00:00
builder-web.opam avoid deprecated functions from Fmt (strf is now str) 2021-10-18 13:22:07 +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 Add README.md 2021-06-29 09:09:52 +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 run by users.

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. Each build has a single binary as output - which checksum is recorded and can be searched for. The build information (opam acpackges, environment variables, host system packages) can be compared, and they may differ even if the checksum of the binary is identical.

The build artifacts are stored on the filesystem, its metadata is stored in the database.

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.

The web server expects a sqlite3 database in its data directory.

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 --help output for each migration for further details.