=============
Release notes
=============

The project is currently released as containers, versioned by release date.
The latest version is tagged ``:latest``.


2025-11-07.1: Multiplying job sources
=========================================

.. admonition:: Breaking changes
   :class: danger

    Upon rebooting on the new image, all your Gitlab runners will get removed
    and re-registered with an extra new tag: ``ci-tron:priority:$PRIORITY``.

    Before rebooting on the new image, please:

    * Back up ``/config/mars_db.yaml``

    * Check that your Gitlab registration/access tokens are still valid by
      either asking the Gitlab instance admin to confirm your tokens are valid,
      or by using the following command and making sure they do not return
      error 401:

      ``curl  --header "PRIVATE-TOKEN: $token" "https://gitlab.freedesktop.org/api/v4/runners"``

    If any of your tokens have expired, please refer to :ref:`MarsDB`
    to see which scopes to request.

The main changes found in this release are:

* Job prioritisation: Get more control over which jobs will run next
* Initial Github support [#initial_github_support]_
* The dashboard v2 now replaces the original dashboard
* It is now possible to disable exposing all runners by default on a job
  source, by setting ``expose_all_runners_by_default=false``
* Switch to Fedora 43

As you can see, this release was focused on increasing compatibility with
forges while keeping the worst-case job execution latency of important jobs in
check by allowing farm admins to specify the priorities of different
forges/projects/users.

Finally, the new dashboard allows interacting with the new features more easily
than having to edit ``/config/mars_db.yaml`` by hand.

.. [#initial_github_support] This version of CI-tron allows you to register your runners on Github, but the official Github action is currently a work in progress.