38 lines
2.0 KiB
Markdown
38 lines
2.0 KiB
Markdown
# RBE toolchain configuration (Linux and Windows)
|
|
|
|
## Linux
|
|
The `rbe_ubuntu2004` directory contains the autogenerated toolchain configuration for linux RBE.
|
|
Run `generate_linux_rbe_configs.sh` to regenerate.
|
|
|
|
## Windows
|
|
|
|
The `rbe_windows_bazel_6.3.2_vs2019` directory contains the autogenerated toolchain configuration for windows RBE.
|
|
The configuration was generated by the `rbe_configs_gen` tool (just as the linux RBE config),
|
|
but since it's a windows configuration, it needs to be run on a windows machine.
|
|
|
|
In order to regenerate:
|
|
- Clone `grpc` repository in a kokoro debug windows VM (see internal documentation for how to create one)
|
|
- Run `generate_windows_rbe_configs.sh` to regenerate the configs locally on the VM.
|
|
- Copy the generated configs back to your workstation (e.g. via `gcloud compute scp` command)
|
|
|
|
Note that the bazel version denotes the bazel version that was used to generate the toolchain configuration. The configuration
|
|
can be use with different bazel versions (as long as it works).
|
|
|
|
Also see go/rbe-windows-user-guide
|
|
|
|
# Windows RBE docker image
|
|
|
|
The `dockerfile/rbe_windows2019` directory contains the dockerfile to rebuild the docker image we use on RBE windows workers. See go/rbe-windows-user-guide.
|
|
|
|
Note that for linux, we use a docker image under `tools/dockerfile` (since for Linux RBE docker image is simply of the testing docker images
|
|
we maintain)
|
|
|
|
## How to rebuild the Windows RBE docker image and use it for Windows RBE
|
|
|
|
On a kokoro debug windows VM, run the following:
|
|
- `docker build -t us-docker.pkg.dev/grpc-testing/testing-images-public/rbe_windows2019 third_party/toolchains/dockerfile/rbe_windows2019`
|
|
- To be able to authenticate when pushing the image to GAR, run `gcloud auth configure-docker us-docker.pkg.dev`
|
|
- `docker push us-docker.pkg.dev/grpc-testing/testing-images-public/rbe_windows2019`
|
|
- Update the `generate_windows_rbe_configs.sh` with the newly built & pushed image's SHA256 digest.
|
|
- Regenerate the Windows RBE toolchain with the instructions above.
|