# 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/
