README.md - meta-agl-demo - meta-agl-demo layer (demo/staging/"one-shot")

blob: aa4823c5c5a6b3368880ceceee381c20028ef9dd (plain)

1	`meta-agl-demo.md`

{ color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */ .highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */ .highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */ .highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */ .highlight .vc { color: #336699 } /* Name.Variable.Class */ .highlight .vg { color: #dd7700 } /* Name.Variable.Global */ .highlight .vi { color: #3333bb } /* Name.Variable.Instance */ .highlight .vm { color: #336699 } /* Name.Variable.Magic */ .highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */ }

## Using --callback-* arguments ##
- - - -

For each LAVA lab target, a configuration file must be created in this repo.
The file name must correspond to the LAVA lab name as registered in KernelCI.\
Using the argument "--callback-from LAB_NAME", the script will search for a file called "LAB_NAME.cfg" in this folder.\
Using the argument "--callback-to KCI_NAME", the script will search in the previous cfg file for a section called KCI_NAME. This section must contain three fields described below.

### Requirements: ###

* Filetype: .cfg
* Filename: <LAB_NAME>.cfg
    * [default] section
        * section = "The section containing the callback data to use by default"
    * [CUSTOM] section
        * backend_fqdn = "The FQDN of the kernelCI backend to callback"
        * lab_name = "The lab name as registered for the kernelCI backend"
        * lab_token = "The kernelCI backend lab token. Usually this is the 'LAVA description' string as shorthand of the token. Alternatively it can be the token itself."

Example file: _lab-mylab.cfg_
```
[default]
section = centralized-kci

[centralized-kci]
backend_fqdn = http(s)://api.centralized-kci.org
lab_name = lab-my-lab
lab_token = lab-my-lab-callback-centralized-kci

[my-dev-kci]
backend_fqdn = http(s)://api.my-dev-kci.org
lab_name = lab-my-lab
lab_token = f1d130b4-8198-4d34-9841-bad7d4ea64d9
```

_Warning:_\
If the lab_token is a LAVA description string, make sure that the actual token is registered in the LAVA interface and matches this string.