.oniro-ci,docs: build RAUC update bundles for RPi4

The update bundle is built with the new hidden job .build-rauc-bundle.
The job is documented and instantiated in the main pipeline.

Signed-off-by: Zygmunt Krynicki <zygmunt.krynicki@huawei.com>

.gitlab-ci.yml

@@ -17,6 +17,7 @@
 stages:
   - compliance
   - build
+  - update
   - test
   - report
   - deploy
@@ -81,6 +82,15 @@ aggregate-docs:
     - if: '$CI_COMMIT_TAG'
       # XXX: This needs CI_ONIRO_MANIFEST_BRANCH as well, most likely.
 
+# Build a RAUC update bundle for Raspberry Pi 4
+bundle-raspberrypi4-64:
+  extends: .build-rauc-bundle
+  stage: update
+  variables:
+    MACHINE: raspberrypi4-64
+    CI_ONIRO_BUILD_FLAVOUR: linux
+    CI_ONIRO_RECIPE_NAME: oniro-bundle-base
+
 # Mimic the updated rules for lava-test from the bitbake-workspace.
 .lava-test:
   rules:

.oniro-ci/build-generic.yaml

@@ -287,6 +287,18 @@
     - echo "Pruning empty directories"
     - find "$CI_PROJECT_DIR"/artifacts/ -type d -exec rmdir --verbose --ignore-fail-on-non-empty {} \; 2>/dev/null || true
 
+.build-rauc-bundle:
+  extends: .build-image
+  script:
+    - !reference [.build-image, script]
+    # Remove everything _except_ for the .raucb.* files. The bundle is
+    # self-sufficient (aka standalone) and does not need any supporting
+    # infrastructure.
+    - echo "Removing non-bundle files"
+    - find "$CI_PROJECT_DIR"/artifacts/images/ \( -type f -o -type l \) -a ! -name "*.raucb" -print -delete
+    - echo "Pruning empty directories"
+    - find "$CI_PROJECT_DIR"/artifacts/ -type d -exec rmdir --verbose --ignore-fail-on-non-empty {} \; 2>/dev/null || true
+
 # This job is currently used to customize the behavior in oniro and xts-acts.
 # It will be removed when that is safe to do so. It is not documented.
 .build:

docs/ci/hidden-jobs/build-rauc-bundle.rst

+.. SPDX-FileCopyrightText: Huawei Inc.
+..
+.. SPDX-License-Identifier: CC-BY-4.0
+
+==================
+.build-rauc-bundle
+==================
+
+The ``.build-rauc-bundle`` job extends the :doc:`build-image` job to collect
+only the `*.raucb.*` file and remove all the other files that would normally be
+collected by the artifact system. It is recommended for Linux builds which
+produce RAUC update bundles.
+
+Usage Guide
+===========
+
+This job is configured exactly the same as :doc:`build-image` and
+:doc:`build-recipe`.

docs/ci/hidden-jobs/index.rst

@@ -23,6 +23,7 @@ implementation details.
    build-recipe
    build-image
    build-wic-image
+   build-rauc-bundle
    build-docs
    lava-test
    lava-report