1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
.. workflow:: blhc
Workflow ``blhc``
====================
This workflow schedules :task:`Blhc` tasks to analyze the logs from builds.
A single :task:`Blhc` is scheduled for each artifact.
* ``task_data``:
* ``prefix`` (string, optional): prefix this string to the item names
provided in the internal collection
* ``reference_prefix`` (string, optional unless
``enable_regression_tracking`` is set): prefix for the item names
provided in the internal collection in the corresponding workflow run
for reference tests
* ``source_artifact`` (:ref:`lookup-single`, optional unless
``enable_regression_tracking`` is set): the
:artifact:`debian:source-package` or :artifact:`debian:upload`
source artifact that the build logs are based on
* ``package_build_logs`` (:ref:`lookup-multiple`, required): the
:artifact:`debian:package-build-log` artifacts to analyze
* ``qa_suite`` (:ref:`lookup-single`, optional unless
``enable_regression_tracking`` or ``update_qa_results`` is True): the
:collection:`debian:suite` collection that reference tests are being run
against to detect regressions
* ``reference_qa_results`` (:ref:`lookup-single`, optional unless
``enable_regression_tracking`` or ``update_qa_results`` is True): the
:collection:`debian:qa-results` collection that contains the reference
results of QA tasks to use to detect regressions
* ``enable_regression_tracking`` (boolean, defaults to False): configure
the workflow to detect and display regressions in QA results
* ``update_qa_results`` (boolean, defaults to False): when set to True,
the workflow runs QA tasks and updates the collection passed in
``reference_qa_results`` with the results.
* ``extra_flags`` (optional): a list of command-line flags to be passed
to each scheduled :task:`Blhc` task
* ``vendor`` (string, required): the distribution vendor, used to build
``environment`` for :task:`Blhc`
* ``codename`` (string, required): the distribution codename, used to
build ``environment`` for :task:`Blhc`
* ``arch_all_build_architecture`` (string, defaults to ``amd64``): concrete
architecture on which to run tasks for binary packages with
``Architecture: all``.
The workflow computes dynamic metadata as:
.. dynamic_data::
:method: debusine.server.workflows.blhc::BlhcWorkflow.build_dynamic_data
The lookup in ``package_build_logs`` may result in :bare-data:`promises
<debusine:promise>`, and in that case the workflow adds corresponding
dependencies. Promises must include ``source_package_name`` and
``source_package_version`` fields in their data.
|
