commit | 924c40c70a7c5a261e17cc78e40c9d4d95bd5183 | [log] [tgz] |
---|---|---|
author | Steven Bergsieker <bergsieker@google.com> | Fri May 15 02:39:59 2020 |
committer | Steven Bergsieker <bergsieker@google.com> | Fri May 15 02:39:59 2020 |
tree | 29bd51275d1f64e20e810831088ca7a9afa80155 | |
parent | b8fc06406b031ad8fdbe18160199953f1c274664 [diff] |
Remove reference to RBE documentation. Change-Id: Iad04cbe435392fdff6a4de3759b10c84c78cf82d
Goma is a distributed compiler service for open-source project such as Chromium and Android. It's some kind of replacement of distcc+ccache.
This is reference implementation of server code to be used with Goma client.
The Goma server uses a backend service that implements the Remote Execution API to distribute compile requests across a collection of worker machines and to cache the results of compilations. The Remote Execution API is an open-source standard, with multiple service implementations. The Goma server has been tested with Google's internal Remote Build Execution service, but could use other service implementations with some minor tweaks to the service code.
Goma server can be built on Linux.
$ GO111MODULE=on go get go.chromium.org/goma/server/cmd/remoteexec_proxy
You will get the binary in $(go env GOPATH)/bin
.
remoteexec_proxy
is a single server that acts as proxy server between Goma client and Remote Execution API.
$ remoteexec_proxy --port $PORT \ --platform-container-image "docker://...@sha256:..." \ --remoteexec-addr $REMOTEEXEC_ADDR \ --remote-instance-name $REMOTE_INSTANCE_NAME
for chromium, platform container image should be created with install-build-dep.sh.
Example Dockerfile
FROM ubuntu:16.04 ENV DEBIAN_FRONTEND noninteractive ADD https://chromium.googlesource.com/chromium/src/+/master/build/install-build-deps.sh?format=TEXT /tmp/install-build-deps.sh.base64 RUN base64 -d /tmp/install-build-deps.sh.base64 > /tmp/install-build-deps.sh \ && \ apt-get -y update \ && \ apt-get install -f -y build-essential gcc-4.8 g++-4.8 docker.io \ && \ bash /tmp/install-build-deps.sh --lib32 --no-prompt \ --no-chromeos-fonts \ && \ rm -rf /var/lib/apt/lists/*
If Remote Execution API requires service account, specify service account JSON file for Remote Execution API by --service-account-json
.
Running user is granted by default. If you need to allow other users, you need to specify them by --whitelisted-users
.
Log messages will be output to stderr.
Install goma client. We provide prebuilt binary with cipd
, which is available in depot_tools
.
$ cipd install infra/goma/client/linux-amd64 -root ${HOME}/goma
or follow the build instructions to build your own local version of Goma client before running the server code, and install it in $HOME/goma
.
Need to authenticate Goma client before use.
$ $HOME/goma/goma_auth.py login
Specify hostname in $GOMA_SERVER_HOST
and port in $GOMA_SERVER_PORT
, along with a few other environment flags.
$ export GOMA_SERVER_HOST='host-of-remoteexec_proxy-running' $ export GOMA_SERVER_PORT='port-of-remoteexec_proxy-running' $ export GOMA_USE_SSL=false $ export GOMA_ARBITRARY_TOOLCHAIN_SUPPORT=true
For example, if you are running remoteexec_proxy locally with --port 5050
, use:
$ export GOMA_SERVER_HOST=localhost $ export GOMA_SERVER_PORT=5050
Finally, start Goma client:
$ $HOME/goma/goma_ctl.py ensure_start
and in chromium tree.
$ rm -f out/Release/obj/base/base/base64.o $ GOMA_USE_LOCAL=false autoninja -C out/Release obj/base/base/base64.o