1# Non-Bazel native tests 2 3This directory contains logic that wraps builds and tests from the non-bazel realm to make them runnable under bazel. 4 5Examples: cmake builds, run_tests.py tests, artifacts, distribtests etc. 6 7NOTE: all tests and their setup under this directory are currently EXPERIMENTAL. 8 9## How it works 10 11The `//tools/bazelify_tests:repo_archive` target produces an archive that contains grpc at the current head with all its submodules. The rule uses a few tricks to achieve this: 12 13* Uses a workspace status command to obtain the commit SHAs of grpc and all submodules from the workspace. 14* When running, it actually jailbreaks from the bazel execroot to access the bazel workspace and create the necessary archives. 15* The produced archives are deterministic (they have the same checksum if neither grpc or its submodules have changed). 16* The target is defined in such a way so that it behaves "reasonably" from bazel's perspective (always re-runs if commit SHAs have changed, can be cached if not). 17 18After grpc source code is archived, the "bazelified" tests basically depend on the archive and they run a script under a docker container. 19The script unpacks the archived grpc code and creates a temporary workspace (under bazel's target execroot) and then performs the actions that are needed 20(e.g. run the run_tests.py test harness, run cmake build etc). 21 22There are two ways the test targets can run under a docker container: 23 24* When running on RBE, all actions run under a docker container by definition. 25* When running locally, bazel will start a docker container for each action when [docker sandbox](https://bazel.build/remote/sandbox) is used. 26 (Note that the docker sandbox currently [doesn't work on windows](https://github.com/bazelbuild/bazel/issues/19101)) 27 28In both cases, the docker image which is used for any given action is determined by the action's `exec_properties` and can be specified as a default 29(e.g. by RBE toolchain or by setting `--experimental_docker_image` flag) or explicitly for each action. For most tests in this directory, 30the test rules actually configure the `exec_properties` for you, based on selecting one of the gRPC's testing docker images. 31 32## Run tests on RBE 33 34``` 35# "--genrule_strategy=remote,local" allows fallback to local execution if action doesn't support running remotely 36# (required to be able to run the //tools/bazelify_tests:repo_archive target). 37tools/bazel --bazelrc=tools/remote_build/linux.bazelrc test --genrule_strategy=remote,local --workspace_status_command=tools/bazelify_tests/workspace_status_cmd.sh //tools/bazelify_tests/test:basic_tests_linux 38``` 39 40## Run tests locally under bazel's docker sandbox 41 42``` 43tools/bazel --bazelrc=tools/remote_build/linux_docker_sandbox.bazelrc test --workspace_status_command=tools/bazelify_tests/workspace_status_cmd.sh //tools/bazelify_tests/test:basic_tests_linux 44``` 45 46