releng-scripts

---

This is an AGL job generation tool for LAVA.
It is written in Python and uses jinja2 templates to generate yaml job files following the LAVA specifications.

This tool only generates jobs. It does not provide a way for submitting jobs to a LAVA server.
Please refer to the lava-tool documentation for submitting jobs.

Prerequisites

• Python >= 2.7.1
• jinja >= 2.9
  • You can check if a version is/was installed with pip using: pip show jinja2
  • If the version is too old, you can update it using: sudo pip install --upgrade jinja2

Usage instructions

The repo contains several tools that are located in the "./utils" folder.
Following is a list of the available tools:

• job-prereq.py a tool that prints the binary packages needed to create a LAVA jobs
• create-jobs.py a tool for generating lava job templates from binary packages hosted on the web

job-prereq.py

Command line tool that prints the packages needed by LAVA to execute a test job.

Required arguments:

• --machine
  • Available machine names: {dra7xx-evm,qemux86-64,porter,m3ulcb,raspberrypi3}
    • For an up to date list of machine names run: ./utils/create-jobs.py --help
• --build-type
  • Needs three arguments formatted as follow: {build-type-name,branch,version}.
    • the build build-type-name must be one of: ci, daily, weekly, release.
    • the build branch or changeid must be a branch name or changeid number.
    • the build version or patchset must be the version or patchset number.

Optionnal arguments

• --dtb
  • prints to stdout the needed dtb package name to create this specific LAVA job definition.
• --kernel
  • prints to stdout the needed kernel package name to create this specific LAVA job definition.
• --initrd
  • prints to stdout the needed ramdisk package name to create this specific LAVA job definition.
• --nbdroot
  • prints to stdout the needed root file system package name to create this specific LAVA job definition.

Exception: if the machine is qemux86-64 only --kernel and --initrd optionnal arguments are available. As qemu LAVA jobs do not need a dtb or nbdroot.

Examples:

./utils/job-prereq.py --machine qemux86-64 --build-type {ci,11524,2} --kernel --initrd
./utils/job-prereq.py --machine raspberrypi3 --build-type {release,eel,v4.9.3} --kernel --initrd --nbdroot --dtb
./utils/job-prereq.py --machine m3ulcb --build-type {daily,eel,v4.9.3} --kernel --dtb
./utils/job-prereq.py --machine dra7xx-evm --build-type {ci,11524,2} --initrd --nbdroot
./utils/job-prereq.py --machine porter --build-type {ci,11524,2} --kernel --initrd --nbdroot --dtb

create-jobs.py

Command line tool to generate AGL jobs for LAVA.

Required arguments:

• ./utils/create-jobs.py --machine machine-name
  • Available machine names: {dra7xx-evm,qemux86-64,porter,m3ulcb,raspberrypi3}
  • For an up to date list of machine names run: ./utils/create-jobs.py --help

Artifacts fetching from URL:

Amongst other things, this tool is used to generate URLs for fetching build artifacts from specific locations.
The default location is: https://download.automotivelinux.org/AGL/\ The default build is dab version 4.0.2

The user can override these defaults using the command line:

• --url <release, daily, ci or http://my-custom-url....>
  • Available url options and their corresponding URL:
    • release: https://download.automotivelinux.org/AGL/release/
    • daily: https://download.automotivelinux.org/AGL/snapshots/
    • ci: https://download.automotivelinux.org/AGL/upload/ci/

If using the url argument the user has to specify other arguments depending on the url:

• release: --branch and --version
• daily: --branch and --version
• ci: --changeid and --patchset

If using a custom url these argument are not used and should not be set. The tool will suppose that the custom url points directly to build artifacts for the target machine.

Examples:

./utils/create-jobs.py --machine m3ulcb
./utils/create-jobs.py --machine qemux86-64
./utils/create-jobs.py --build-type release --branch eel --version 4.99.1 --machine m3ulcb
./utils/create-jobs.py --build-type release --branch eel --version 4.99.1 --machine qemux86-64
./utils/create-jobs.py --build-type daily --branch master --version latest --machine m3ulcb
./utils/create-jobs.py --build-type daily --branch master --version latest --machine raspberrypi3
./utils/create-jobs.py --build-type ci --changeid 13079 --patchset 1 --machine raspberrypi3
./utils/create-jobs.py --build-type ci --changeid 13079 --patchset 1 --machine m3ulcb
./utils/create-jobs.py --url http://baylibre.com/pub/agl/ci/raspberrypi3 --machine raspberrypi3
./utils/create-jobs.py --url http://baylibre.com/pub/agl/ci/raspberrypi3 --build-type release --machine raspberrypi3

The full list of arguments with default values is available using the helper:
$ ./utils/create-jobs.py --help

Add tests to a job

To add tests to a job description please refer to the specific documentation: [releng-scripts-folder]/doc/test-documentation.md