OfBorg: Difference between revisions

Latest revision as of 08:18, 28 September 2024

This article or section needs expansion.

Reason: This page is a work in progress. (Discuss in Talk:OfBorg#)
Please consult the pedia article metapage for guidelines on contributing.

OfBorg is the primary CI service on Nixpkgs.

Checks

This section outlines the various checks which OfBorg performs.

ofborg-eval

Checks that the changed Nix Expression Language files are valid.

ofborg-eval-check-maintainers

Checks that the changed package's maintainers are added to maintainers/maintainer-list.nix.

This action returns a GitHub Gist with all maintainers found for a package.

ofborg-eval-check-meta

Checks that modified packages have an associated meta table inside of derivations.

ofborg-eval-darwin

Checks that the modified packages build correctly on Darwin (macOS) systems.

ofborg-eval-nixos

Checks that the modified packages build correctly on NixOS.

Commands

See [1].

Status

To see live logs from ofborg for a pull request, you can go to https://logs.ofborg.org/?attempt_id=-ofborg-&key=nixos%2Fnixpkgs.<PR NUMBER>. Replace <PR NUMBER> with the number of your pr, e.g 123456

To see the queue status for the builders, you can use the ofborg prometheus instance.

You can also find alerts on this prometheus instance.

Additionally, statistics about the size of the various build queues are available at stats.php.

Links

OfBorg's source
OfBorg's documentation: Has instructions for operating a builder (as well as setting it up on MacOS).

@@ Line 1: / Line 1: @@
-{{WIP}}
+{{expansion|This page is a work in progress.}}
 '''OfBorg''' is the primary CI service on [[Nixpkgs]].
@@ Line 7: / Line 7: @@
 === ofborg-eval ===
-Checks that the changed [[Nix]] files are valid.
+Checks that the changed [[Nix Expression Language]] files are valid.
 === ofborg-eval-check-maintainers ===
@@ Line 22: / Line 22: @@
 === ofborg-eval-nixos ===
 Checks that the modified packages build correctly on [[NixOS]].
+== Commands ==
+See [https://github.com/NixOS/ofborg#commands].
+== Status ==
+To see live logs from ofborg for a pull request, you can go to <code><nowiki>https://logs.ofborg.org/?attempt_id=-ofborg-&key=nixos%2Fnixpkgs.&lt;PR NUMBER&gt;</nowiki></code>. Replace <code>&lt;PR NUMBER&gt;</code> with the number of your pr, e.g <code>123456</code>
+To see the queue status for the builders, you can use [https://ofborg.org/prometheus/graph?g0.expr=ofborg_queue_builder_waiting{arch!%3D%22aarch64-darwin-lowprior%22%2Carch!%3D%22x86_64-darwin-lowprior%22}%20or%20ofborg_queue_evaluator_waiting&g0.tab=0&g0.stacked=0&g0.show_exemplars=0&g0.range_input=3d the ofborg prometheus instance].
+You can also find [https://ofborg.org/prometheus/alerts alerts] on this prometheus instance.
+Additionally, statistics about the size of the various build queues are available at [https://events.ofborg.org/stats.php stats.php].
 == Links ==
 * [https://github.com/NixOS/ofborg OfBorg's source]
+* [https://github.com/NixOS/ofborg/wiki OfBorg's documentation]: Has instructions for operating a builder (as well as setting it up on MacOS).
 [[Category:Pedias]]