History

Petr Štetiar ac834c9082 ci: fix wasting of runtime testing resources after failed builds Currently we're wasting roughly about 3 minutes of precious testbed time when the firmware build CI job fails, every time. Due to increased testing, this is no longer acceptable waste of testing resources. During the investigation it was found out, that this is happening due to changes introduced in commit febd8b0032fa (".gitlab: Only run tests when TFTP_IMAGE_DOWNLOAD_URL is set"), feature which was mainly introduced to allow testing of externally build firmware images inside SoftAtHome for previous, pre-2024 contribution delivery workflow. This is no longer being used. So lets fix it, but removing of TFTP_IMAGE_DOWNLOAD_URL feature. If we need this feature again, it should be implemented in a different way, avoiding wasting of the testbed resources after failed build. Additionally, we need to change `rules: - when: always` in testbed.yml, as it would still make run the CI job, despite of the failed dependency, resorting back to the default `on_success` when rules, where the job is run only when no jobs in earlier stages fail. Signed-off-by: Petr Štetiar <petr.stetiar@prplfoundation.org>		2025-07-31 15:27:24 +00:00
..
cdrouter	ci: fix wasting of runtime testing resources after failed builds	2025-07-31 15:27:24 +00:00
certs	ci: ssh-server: add tests for pubkey auth and session features	2025-07-31 10:35:18 +00:00
docker	ci: ipq807x: fix filenames and references after target rename to qualcommax	2025-07-31 15:25:51 +00:00
mockups	ci: sync with current prplos branch state	2025-07-31 10:31:53 +00:00
scripts	ci: cdrouter: dut-init: add cdrouter-dut-configure-cwmpd.sh	2025-07-31 15:25:26 +00:00
testbed	ci: ipq807x: fix filenames and references after target rename to qualcommax	2025-07-31 15:25:51 +00:00
tests	ci: fix wasting of runtime testing resources after failed builds	2025-07-31 15:27:24 +00:00
build.yml	ci: fix wasting of runtime testing resources after failed builds	2025-07-31 15:27:24 +00:00
cdrouter.yml	ci: fix wasting of runtime testing resources after failed builds	2025-07-31 15:27:24 +00:00
coverity.yml	ci: coverity: fix build timeout failure by increasing the timeout to 6 hours	2025-07-31 15:23:34 +00:00
docker.yml	ci: fix wasting of runtime testing resources after failed builds	2025-07-31 15:27:24 +00:00
README.md	profiles,ci: sunset webui profile	2025-07-31 10:33:15 +00:00
release.yml	ci: ipq807x: fix filenames and references after target rename to qualcommax	2025-07-31 15:25:51 +00:00
sdk.yml	ci: ipq807x: fix filenames and references after target rename to qualcommax	2025-07-31 15:25:51 +00:00
testbed.yml	ci: fix wasting of runtime testing resources after failed builds	2025-07-31 15:27:24 +00:00

README.md

Content

This directory contains stuff used on the GitLab CI.

docker

Contains definitions for Docker images.

testbed

Contains definitions for testbed related tests.

scripts

Contains scripts used on GitLab CI.

tests

Contains tests used on GitLab CI.

build.yml

Contains definition of the GitLab CI build test job templates used during build stage. Those templates can then be extended by other GitLab CI jobs in order to keep things DRY.

.build test config

Allows build testing of specific configurations defined in the profiles directory, using scripts/gen_config.py under the hood.

Example usage:

include:
 - local: .gitlab/build.yml

stages:
 - build

build test netgear-rax40 prpl:
  extends: .build test config

Which is going to build test prplOS with netgear-rax40 and prpl profiles.

Description of CI variables:

CI_BUILD_CONFIG_EXTRA - list of additional config options which should be enabled(prefixed with +) or disabled (prefixed with -), for example +BUILD_LOG -SDK would result in CONFIG_BUILD_LOG=y and CONFIG_SDK=y config symbols in .config file.

docker.yml

Provides support for building, tagging and pushing the Docker images to image registry.

For example let's build image foo.

Prerequisites:

Create directory for new Docker image mkdir -p .gitlab/docker/foo
Docker image description $EDITOR .gitlab/docker/foo/Dockefile

Then just put following into .gitlab/docker/foo/gitlab.yml

build Docker image foo:
  extends: .build Docker image

testbed.yml

Provides bits needed for runtime testing on real device using labgrid Python testing framework.

Supported devices:

Netgear RAX40

sdk.yml

Provides support for the OpenWrt SDK utilizing the Docker SDK container under the hood.

.build feed with SDK

Allows compile testing of packages using the SDK.

Example usage, build testing of safec3 package from Intel's feed_opensource_apps feed.

include:
  - remote: https://gitlab.com/prpl-foundation/prplOS/prplos/-/raw/prplos/.gitlab/sdk.yml

build:
  extends: .build feed with SDK
  variables:
    CI_SDK_INSTALL_FEEDS: feed_target_mips
    CI_SDK_BUILD_PACKAGES: safec3

Description of CI variables:

CI_SDK_INSTALL_FEEDS - list of feeds which should be installed prior to building packages.
CI_SDK_BUILD_PACKAGES - list of packages which should be compile tested.
CI_SDK_BUILD_PARALLEL - max number of threads to use for make (defaults to nproc if unset).

.generate SDK package build jobs

Generates sdk-package-jobs.yml with separate build jobs for every package so the builds of those packages can run in parallel. It's supposed to be executed by the child pipeline .execute SDK package build jobs.

.execute SDK package build jobs

It's supposed to execute jobs generated in sdk-package-jobs.yml generated by .generate SDK package build jobs job.