Commit 8c552860 authored by Dominique Barton's avatar Dominique Barton 🦄
Browse files

DOC: Add dedicated GitLab CI files section

parent 2f712dcf
Pipeline #10120 passed with stage
in 19 seconds
...@@ -9,11 +9,21 @@ GitLab will read this file and run the defined pipelines for you. ...@@ -9,11 +9,21 @@ GitLab will read this file and run the defined pipelines for you.
Usually you want to run as much tests as possible. Usually you want to run as much tests as possible.
This is most likely achieved by running all the ``make test-*`` commands in the test stage of the pipeline. This is most likely achieved by running all the ``make test-*`` commands in the test stage of the pipeline.
.. hint::
To configure your GitLab CI pipeline, have a look at the existing projects or the `shared GitLab CI <https://git.confirm.ch/confirm/gitlab-ci>`_ files.
.. important:: .. important::
Have a look at the :ref:`GitLab` section and ensure merge requests can not be accepted until the **pipeline succeeds**. Have a look at the :ref:`GitLab` section and ensure merge requests can not be accepted until the **pipeline succeeds**.
This helps to avoid non-compliant code in the live project. This helps to avoid non-compliant code in the live project.
Shared GitLab CI files
----------------------
To configure your GitLab CI pipeline, have a look at the existing projects or the `shared GitLab CI <https://git.confirm.ch/confirm/gitlab-ci>`_ files.
The advantages of the shared CI files are:
- Pipelines are **centralised** and can (mostly) be managed in a single place
- Changes and bug fixes must only be **applied once** (vs. multiple projects)
- Functionaly can be **shared** used multiple times without repeating yourself (DRY)
- CI files are **modular** and can depend on each other
- Managing the CI/CD process can be done by a **single party** (i.e. CI/CD expert)
- Developers only need to **refer files by inclusion** (no deep CI/CD knowhow required)
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment