diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 19:33:14 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 19:33:14 +0000 |
commit | 36d22d82aa202bb199967e9512281e9a53db42c9 (patch) | |
tree | 105e8c98ddea1c1e4784a60a5a6410fa416be2de /third_party/libwebrtc/infra/config/README.md | |
parent | Initial commit. (diff) | |
download | firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.tar.xz firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.zip |
Adding upstream version 115.7.0esr.upstream/115.7.0esr
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'third_party/libwebrtc/infra/config/README.md')
-rw-r--r-- | third_party/libwebrtc/infra/config/README.md | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/third_party/libwebrtc/infra/config/README.md b/third_party/libwebrtc/infra/config/README.md new file mode 100644 index 0000000000..ef60c763db --- /dev/null +++ b/third_party/libwebrtc/infra/config/README.md @@ -0,0 +1,52 @@ +# 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 master 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/+/master/lucicfg/doc/ |