gitlab-ci: shorten job prefixes

This helps to maximize the amount of information visible in the GitLab
web interface.

Also document their meaning in the developer documentation and in the CI
configuration file directly.

See: https://gitlab.com/gitlab-org/gitlab/-/issues/8496
This commit is contained in:
Ben Boeckel
2021-11-19 20:29:13 -05:00
parent 3c2fedfeaf
commit c0d8e42a08
3 changed files with 166 additions and 146 deletions

View File

@@ -324,6 +324,19 @@ Heavier jobs require a manual trigger to run:
* ``failed``: Restart jobs which have completed, but without success.
* ``completed``: Restart all completed jobs.
In order to keep job names shorter and keep as much information visible on the
GitLab web interface as possible, jobs have a short prefix which indicates
what its main purpose is:
* ``b:`` jobs build CMake for the purposes of running the
test suite.
* ``l:`` jobs perform "linting" on the CMake source tree such as static
analysis.
* ``p:`` jobs perform preparatory tasks for use in other jobs.
* ``t:`` jobs perform testing of CMake.
* ``u:`` jobs upload other job results to permanent locations.
If the merge request topic branch is updated by a push, a new manual trigger
using one of the above methods is needed to start CI again.