Job builder-web on debian-11
README
Skip to buildsBuilder-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.
Less common workflows
Here are listed some less common but useful workflows:
Extracting builds from one server to another
This is useful for development on a separate machine that doesn't run the build jobs itself.
On the source server:
builder-db extract-build <build-hash> --dest <build-hash>.full
After copying the file over the destination server (you need a user first,
see builder-db user-add --help
):
curl --data-binary @<build-hash>.full http://<user>:<passwd>@localhost:<builder-web-port>/upload
Builds
Back to readme- ☑ debian-11 2024-09-07 14:11:45Z builder-web.deb
SHA256:319e02b02db61739b65d22ffa7545178aa2ac486949c27a17651a1a7449a9019
(14.3MB) - ☑ debian-11 2024-09-05 14:30:10Z builder-web.deb
SHA256:f3bed930efc1e0ca23ff23e1c2f3bd07a7a973f78f31eda95d0b316b57f09c75
(14.5MB) - ☑ debian-11 2024-09-03 14:00:45Z builder-web.deb
SHA256:5eb1e0f5d4f694c197ce91296d8b007ea13c0bd6741e072e5629ecbdf0f7f8ee
(14.5MB) - ☑ debian-11 2024-08-23 14:13:09Z builder-web.deb
SHA256:7a44c53edc9b03018b2fb540b542eb1a7512daea505afc095fb728931e4cc5f2
(14.4MB) - ☑ debian-11 2024-08-22 14:00:37Z builder-web.deb
SHA256:154fcb79d8435ad682763349c60bfaf834f6d9e23f9ac6ef18cc2d1747b36b3e
(14.4MB) - ☑ debian-11 2024-08-21 14:30:38Z builder-web.deb
SHA256:0f2c0fb5aeda5b53a0db969b0643bad9518cbd9a70012af1fefad8e5a6310a5d
(14.4MB) - ☑ debian-11 2024-08-13 14:04:15Z builder-web.deb
SHA256:0941e2aaa957ed8ba91b628c3bbebc5ef62f7ad64f73511276baacb4448a44ff
(12.9MB) - ☑ debian-11 2024-08-06 14:25:16Z builder-web.deb
SHA256:f2de62e56b4055a3277f8bbd2e1c54e0c7d78458d5f9c1ecb4355976c5afad4c
(12.9MB) - ☑ debian-11 2024-07-20 14:10:55Z builder-web.deb
SHA256:dfe4f8063e07656a47cb06ec631f0a69726c432d894c135ac0a03136de86905d
(12.9MB) - ☑ debian-11 2024-07-15 10:55:18Z builder-web.deb
SHA256:f4ca75be5c43f92dfd178b777286584293abb039c97a890f69761ed3327573d9
(12.9MB) - ☑ debian-11 2024-07-02 14:10:30Z builder-web.deb
SHA256:91a8b9e64b1b54b242ae4184231b172bbfa2ae3764d9e0a4c5c1c98066daf7f0
(12.5MB) - ☑ debian-11 2024-06-28 14:05:17Z builder-web.deb
SHA256:1ec36364980a720001c5be74bfc7baee94a08a804f7ac3893f8e2a26e55da3ca
(12.5MB) - ☑ debian-11 2024-06-26 14:02:05Z builder-web.deb
SHA256:7b51853aac8b314eb29514fd34c22e49d6c41e8644aa30dc8888a05afc2b51f7
(8.89MB)
Including failed builds here.