Google Git
Sign in
android / platform / external / bazelbuild-remote-apis / refs/heads/build-tools-release
commite0e5a5351a4571f63506eec04ee49a3dd1e60327[log] [tgz]
authorDan Willemsen <dwillemsen@google.com>Tue Apr 09 20:34:05 2019 +0000
committerDan Willemsen <dwillemsen@google.com>Tue Apr 09 20:35:21 2019 +0000
treef81dc1c1ece7b9c9c08b90345aa4c10293be9deb
parent1a875d78a7cc496cfd7c51ef3faa146ddfc1e70e [diff]
parent6a5a17b77bca5e70417746fd0616db3849731619 [diff]
Merge branch 'aosp/upstream-master'

Includes android-required NOTICE/MODULE_LICENSE*/METADATA files.

Test: treehugger
Change-Id: Ie31d99425f7c8d907c0284a68e385bdde009464c
tree: f81dc1c1ece7b9c9c08b90345aa4c10293be9deb
  1. build/
  2. external/
  3. NOTICE ⇨ LICENSE
  4. .gitignore
  5. AUTHORS
  6. CODEOWNERS
  7. CONTRIBUTING.md
  8. CONTRIBUTORS
  9. LICENSE
  10. METADATA
  11. MODULE_LICENSE_APACHE2
  12. README.md
  13. WORKSPACE
README.md

Remote Execution API

The Remote Execution API is an API that, at its most general, allows clients to request execution of binaries on a remote system. It is intended primarily for use by build systems, such as Bazel, to distribute build and test actions through a worker pool, and also provide a central cache of build results. This allows builds to execute faster, both by reusing results already built by other clients and by allowing many actions to be executed in parallel, in excess of the resource limits of the machine running the build.

There are a number of clients and services using these APIs, they are listed below.

Clients

These tools use the Remote Execution API to distribute builds to workers.

Servers

These applications implement the Remote Execution API to server build requests from the clients above. These are then distributed to workers; some of these workers implement the Remote Worker API.

Dependencies

The APIs in this repository refer to several general-purpose APIs published by Google in the Google APIs repository. You will need to refer to packages from that repository in order to generate code using this API. If you build the repository using the included BUILD files, Bazel will fetch the protobuf compiler and googleapis automatically.

Using the APIs

The repository contains BUILD files to build the protobuf library with Bazel. If you wish to use them with your own project in Bazel, you will possibly want to declare cc_proto_library, java_proto_library, etc. rules that depend on them.

Other build systems will have to run protoc on the protobuf files, and link in the googleapis and well-known proto types, manually.