From 36d22d82aa202bb199967e9512281e9a53db42c9 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 21:33:14 +0200 Subject: Adding upstream version 115.7.0esr. Signed-off-by: Daniel Baumann --- third_party/libwebrtc/infra/config/README.md | 52 ++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 third_party/libwebrtc/infra/config/README.md (limited to 'third_party/libwebrtc/infra/config/README.md') 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/ -- cgit v1.2.3