smallsolar/u-boot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc: Add pointers to the concept tree

Browse Source 
Expand the CI documentation to mention the concept tree. Add a reference
to the page from the build page.

Signed-off-by: Simon Glass <sjg@chromium.org>
This commit is contained in:
Simon Glass
2025-07-12 08:18:04 +02:00
parent 7627e3cdb8
commit 213cc053f0
2 changed files with 29 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
doc/build/docker.rst vendored
View File

@@ -1,5 +1,7 @@
GitLab CI / U-Boot runner container
===================================
U-Boot runner container
=======================
See also :doc:`/develop/ci_testing`.
In order to have a reproducible and portable build environment for CI we use a container for building in. This means that developers can also reproduce the CI environment, to a large degree at least, locally. This file is located in the tools/docker directory.

30
doc/develop/ci_testing.rst
View File

@@ -40,7 +40,24 @@ then the "Checks" tab will show the results.
GitLab CI Pipelines
-------------------
This pipeline is defined in the top-level ``.gitlab-ci.yml`` file. Currently,
`Gitlab <https://gitlab.com>`_ is used for building and testing U-Boot. There
are two separate instances:
- `Denx <https://source.denx.de>`_ - main tree, including custodian trees
- `Concept <https://concept.u-boot.org/u-boot/u-boot>`_ - concept tree
This pipeline is defined in the top-level ``.gitlab-ci.yml`` file.
To push to Gitlab without triggering a pipeline use:
.. code-block:: bash
git push -o ci.skip
Denx
~~~~
Currently with the main tree,
we support running GitLab CI pipelines only for custodians, due to the
resources the project has available. For Custodians, it is a matter of
enabling the pipeline feature in your project repository following the standard
@@ -50,11 +67,14 @@ runners you are able to provide. While it is intended to be able to run this
pipeline on the free public instances provided at https://gitlab.com/ a problem
with our squashfs tests currently prevents this.
To push to Gitlab without triggering a pipeline use:
Concept
~~~~~~~
.. code-block:: bash
git push -o ci.skip
Contributors can request a login at `U-Boot Concept <concept.u-boot.org>`_
(after sending an email to Simon Glass <sjg@chromium.org> as shown there).
Contributors are then able to push branches and trigger a CI run. The
``.gitlab-ci.yml`` is slightly different from the main tree and CI runs
are generally twice as fast to complete.
Docker container
----------------