Google Git
Sign in
gerrit / luci-config / refs/heads/main
commitbe021e9f4dffb0e7ebe73a09f70cbf1edf0762bc[log] [tgz]
authorKamil Musin <kamilm@google.com>Wed Sep 18 13:20:51 2024 +0200
committerKamil Musin <kamilm@google.com>Wed Sep 18 13:23:00 2024 +0200
tree8eacb88e49f96fd0c5b382567588fddbf4bb7838
parent6a85c1ff94420d0d21583d0d61bb327d074fa0e0 [diff]
Replace .join with /

The paths in LUCI got updated to pathlib.Path which don't have .join
method

Generated files got updated by running the commands in README.

Google-Bug-Id: b/365565157
Release-Notes: skip
Change-Id: I313ccfbfac0d4ddb9af09b4d2b0e4884ea18d280
3 files changed
tree: 8eacb88e49f96fd0c5b382567588fddbf4bb7838
  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