infra/config/README.md

# infra/config folder

This folder contains WebRTC project-wide configurations for Chrome infra
services, mainly the CI system ([console][]).

`*.cfg` files are the actual configuration that [LUCI][luci-config] looks at.
They are in *protocol buffer text format*. For example,
[cr-buildbucket.cfg](cr-buildbucket.cfg) defines builders.

However, they are all automatically generated from the [Starlark][] script
[config.star](config.star) that defines a unified config using **[lucicfg][]**.
The main body of the config is at the bottom of the file, following all the
helper definitions.

`lucicfg` should be available as part of depot_tools. After editing
[config.star](config.star) you should run `lucicfg generate config.star` to
re-generate `*.cfg` files. Check the diffs in generated files to confirm that
your change worked as expected. Both the code change and the generated changes
need to be committed together.

## Uploading changes

It is recommended to have a separate checkout for this branch, so switching
to/from it does not populate/delete all files in the main branch.

Initial setup:

```bash
git clone https://webrtc.googlesource.com/src/
```

Now you can create a new branch to make changes:

```bash
git new-branch add-new-builder
# edit/generate files
git commit -a
git cl upload
```

Changes can be reviewed on Gerrit and submitted with commit queue as usual.

### Activating the changes

Any changes to this directory go live soon after landing, without any additional
steps. You can see the status or force a refresh of the config at
[luci-config][].

[console]: https://ci.chromium.org/p/webrtc/g/ci/console
[luci-config]: https://luci-config.appspot.com/#/projects/webrtc
[starlark]: https://github.com/google/starlark-go
[lucicfg]: https://chromium.googlesource.com/infra/luci/luci-go/+/main/lucicfg/doc/