Google Git
Sign in
gerrit / luci-config / 500163313cabc9176429e773ec04e06d9c3d94a1
commit500163313cabc9176429e773ec04e06d9c3d94a1[log] [tgz]
authorFrank Borden <frankborden@google.com>Thu Feb 23 13:17:10 2023 +0100
committerFrank Borden <frankborden@google.com>Thu Feb 23 13:20:41 2023 +0100
tree053e71fa331d8f792ccc39c073ba3b8a290eff65
parentc16abfabcbb6e88ef847f8c77291d0228e3c496a [diff]
Introduce cq_group for luci-config repo

This will allow LUCI to be used to merge changes on this repo, which is
needed to let the autoroller submit it's trivial dep bumps by uploading
a change and voting with Bot-Commit +1 and CQ+2 labels. One example is
Change 360416 that I am currently stamping and merging manually.

This is still secure from other users trying to circumvent CR+2
requirement because only the autoroller account can vote Bot-Commit +1.

Change-Id: Ia7867a251ca442a29fd49f2e8459359f1a25b899
3 files changed
tree: 053e71fa331d8f792ccc39c073ba3b8a290eff65
  1. generated/
  2. infra/
  3. recipes/
  4. repos/
  5. .gitignore
  6. main.star
  7. README.md
README.md

LUCI Configuration

This repo holds all the configuration for LUCI, the CI system Gerrit uses. You can find recent verification runs and logs at https://ci.chromium.org/ui/p/gerrit/builders.

Concepts

  • Recipe: a python script to verify a change, and a test for that verification
  • Builder: a recipe configured to run on a specific machine type
  • CQ Group: a watcher that triggers on new votes/patchsets on the specified repo+refs
  • CQ Tryjob Verifier: combines a CQ group with a builder to run a recipe when a new vote or patchset comes in

Layout

  • /main.star: overall starlark configuration for the entire host. It is also executable to generate the config data
  • /repos/*.star: repo-specific starlark configuration for builders, CQ groups, CQ tryjob verifiers, etc
  • /recipes/recipes/*.py: recipes for testing a change based on the repo
  • /recipes/recipes.py: executes recipe tests and compares/generates expected JSON goldens. 100% coverage is expected.
  • /recipes/recipe_modules/: dependencies shared by modules
  • /recipes/*.expected/*.json: expected commands executed by the recipe
  • /infra/config/recipes.cfg: versions and URLs of external recipe dependencies

Prerequisites

  • lucicfg - CLI tool to generate the configuration from the starlark scripts. To install, clone depot_tools.
  • python - Python 3, used to execute recipes.

Imporant commands

Regenerate config data after making changes (lucicfg):

$ ./main.star

Run recipe tests (python):

$ recipes/recipes.py test run

Update recipe test goldens (python):

$ recipes/recipes.py test train

Documentation