Gold standard test jobs¶
The next step after the first example job, is to move on to gold standard test jobs. These include a test job for QEMU and test jobs for readily available ARM devices like cubietruck and beaglebone-black.
Test writers are strongly recommended to follow these examples to have a known
working setup for later test jobs. These standard test jobs are part of the
regular functional testing performed by the LAVA software team prior to each
release. If you have problems debugging a test job failure on any instance of
LAVA, your recommended first action is to submit the closest standard test job
and compare the results against other instances like
staging.validation.linaro.org. To make this easier, all test writers are
recommended to use version control for all test jobs and to keep a local copy
of the closest standard test job for quick reference.
A gold standard deployment for one device type is not necessarily supported for a second device type. Some devices will never be able to support all deployment methods due to hardware constraints or the lack of kernel support. This is not a bug in LAVA. If a particular deployment is supported but not stable on a device type, there will not be a gold standard image for that deployment. Any issues in the images using such deployments on that type are entirely down to the test writer to fix.
Device type templates and other instance-specific configuration could
affect the standard test jobs on specific instances. If a standard test job
fails, check with the admins for that particular instance. The standard
tests described here use support in the default device-type templates
shipped with LAVA and are routinely tested on
Standard test jobs include metadata which links the test job back to the build information, logs and scripts.
Metadata consists of a series of key value pairs where the key must be a single word (no whitespace, underscores and hyphens are allowed). Keys must be unique within the metadata.Keys used in metadata should be consistent across particular groups of test jobs with data specific to that test job in the value.
Ensure that you change the metadata to point at your local repository so that you can easily distinguish between the results with and without your modifications:
metadata: source: https://gitlab.com/lava/lava path: doc/v2/examples/test-jobs/qemu-amd64-standard-stretch.yaml
Automated test jobs should always use the metadata to specify:
the source repository of the job definition
the path to the job definition within the source repository
the details of the build
links to the build logs
links to the build scripts.
These details allow other users to adapt and modify the build artifacts for further tests.
The set of gold standard jobs has been defined in association with the Linaro QA team. These jobs will provide a known baseline for test definition writers, in a similar manner to the way the existing QA test definitions provide a base for more elaborate testing.
Metadata also exists in the Lava Test Shell Definition but this is only used when writing the test shell definition, it is not picked up by LAVA. It remains useful to record the maintainer of a test shell definition, the scope and the kinds of devices for which the definition is expected to be useful. see also Test Definitions To explicitly add limited metadata to the job from the Lava Test Shell Definition, see Recording test case references. The job will automatically contain metadata relating to the URL, commit hash and path of the test shell definition(s) used in the test job.