prysm-pulse/tools/cross-toolchain
Preston Van Loon a19044051f
Add hermetic_cc_toolchain for a hermetic cc toolchain (#12135)
* Add bazel-zig-cc for a hermetic cc toolchain

* gazelle

* Remove llvm

* remove wl

* Add new URLs for renamed repo

* gazelle

* Update to v2.0.0-rc1

* bump to rc2

* Some PR feedback

* use v2.0.0 from rc2

* Disable hermetic builds for mac and windows.

* bump bazel version, add darwin hack

* fix

* Add the no-op emtpy cc toolchain code

* typo and additional copy

* update protobuf and fix vaticle warning

* Revert "update protobuf and fix vaticle warning"

This reverts commit 7bb4b6b564d2d588567d08dfdd3b9837c26d3c05.

---------

Co-authored-by: prylabs-bulldozer[bot] <58059840+prylabs-bulldozer[bot]@users.noreply.github.com>
2023-06-26 14:31:40 +00:00
..
configs Update bazel to 6.1.0 (#12121) 2023-03-13 23:17:26 +00:00
BUILD.bazel First cut at multi-arch cross compiling toolchain (#4945) 2020-03-05 16:59:56 +00:00
cc_toolchain_config_linux_arm64.bzl.tpl Update bazel to 6.1.0 (#12121) 2023-03-13 23:17:26 +00:00
cc_toolchain_config_osx.bzl.tpl Update bazel to 6.1.0 (#12121) 2023-03-13 23:17:26 +00:00
cc_toolchain_config_windows.bzl.tpl Update bazel to 6.1.0 (#12121) 2023-03-13 23:17:26 +00:00
cc_toolchain.BUILD.bazel.tpl Add cross compilation for OSX ARM64 (Apple Silicon) (#10981) 2022-08-11 21:40:24 +00:00
common_osxcross.sh Add cross compilation for OSX ARM64 (Apple Silicon) (#10981) 2022-08-11 21:40:24 +00:00
cpp_env_clang.json Update cross compile toolchains (#12069) 2023-03-07 20:09:46 +00:00
darwin_cc_hack.bzl Add hermetic_cc_toolchain for a hermetic cc toolchain (#12135) 2023-06-26 14:31:40 +00:00
Dockerfile Update cross compile toolchains (#12069) 2023-03-07 20:09:46 +00:00
install_clang_cross.sh Add cross compilation for OSX ARM64 (Apple Silicon) (#10981) 2022-08-11 21:40:24 +00:00
install_osxcross.sh Add cross compilation for OSX ARM64 (Apple Silicon) (#10981) 2022-08-11 21:40:24 +00:00
link_osxcross.sh Add cross compilation for OSX ARM64 (Apple Silicon) (#10981) 2022-08-11 21:40:24 +00:00
prysm_toolchains.bzl First cut at multi-arch cross compiling toolchain (#4945) 2020-03-05 16:59:56 +00:00
README.md Update bazel to 6.1.0 (#12121) 2023-03-13 23:17:26 +00:00

Multiarch Cross Compiling Toolchain

Toolchain suite

This package declares a c++ toolchain suite with cross compilers for targeting five platforms:

  • linux_amd64
  • linux_arm64
  • osx_amd64
  • osx_arm64
  • windows_amd64

This toolchain suite describes cross compile configuration with a Dockerfile with the appropriate host dependencies. These toolchains can be used locally (see caveats), Remote Build Execution (RBE), and in a docker sandbox (like RBE, but local).

Updating the toolchain suite

  1. Build and push the worker docker image, if necessary.
docker build -t gcr.io/prysmaticlabs/rbe-worker:latest tools/cross-toolchain/.
docker push gcr.io/prysmaticlabs/rbe-worker:latest 

Note: You must configured your gcr access credentials to push to gcr.io/prysmaticlabs. Run gcloud auth configure-docker or contact SRE team for push access.

  1. Note the docker image sha256 digest from the recently pushed image or use the latest one available.

  2. Download and run rbe_configs_gen CLI tool.

# Run from the root of the Prysm repo.
rbe_configs_gen \
  --bazel_version=$(cat .bazelversion) \
  --target_os=linux \
  --exec_os=linux \
  --output_src_root=tools/cross-toolchain/configs \
  --generate_cpp_configs=true \
  --generate_java_configs=true \
  --cpp_env_json=tools/cross-toolchain/cpp_env_clang.json \
  --toolchain_container=gcr.io/prysmaticlabs/rbe-worker@sha256:90d490709a0fb0c817569f37408823a0490e5502cbecc36415caabfc36a0c2e8 # The sha256 digest from step 2.
  1. Test the builds work locally for all supported platforms.
bazel build --config=release --config=linux_amd64 --config=llvm //cmd/beacon-chain //cmd/validator //cmd/client-stats //cmd/prysmctl
bazel build --config=release --config=linux_arm64_docker //cmd/beacon-chain //cmd/validator //cmd/client-stats //cmd/prysmctl
bazel build --config=release --config=osx_amd64_docker //cmd/beacon-chain //cmd/validator //cmd/client-stats //cmd/prysmctl
bazel build --config=release --config=osx_arm64_docker //cmd/beacon-chain //cmd/validator //cmd/client-stats //cmd/prysmctl 
bazel build --config=release --config=windows_amd64_docker //cmd/beacon-chain //cmd/validator //cmd/client-stats //cmd/prysmctl
  1. Run gazelle.
bazel run //:gazelle
  1. Add and commit the newly generated configs.

  2. Done!

Cross compile target support

target linux_amd64 linux_arm64 osx_amd64 osx_arm64 windows_amd64
//beacon-chain ✔️ docker-sandbox and RBE, supported locally only ✔️ docker-sandbox and RBE ✔️ docker-sandbox ✔️ docker-sandbox ✔️ docker-sandbox
//validator ✔️ docker-sandbox and RBE ✔️ docker-sandbox and RBE ✔️ docker-sandbox ✔️ docker-sandbox ✔️

The configurations above are enforced via pull request presubmit checks.

Bazel config flag values

Use these values with --config=<flag>, multiple times if more than one value is defined in the table. Example: bazel build //beacon-chain --config=windows_amd64_docker to build windows binary in a docker sandbox.

Config linux_amd64 linux_arm64 osx_amd64 osx_arm64 windows_amd64
Local run linux_amd64 linux_arm64 osx_amd64 osx_arm64 windows_amd64
Docker sandbox linux_amd64_docker linux_arm64_docker osx_amd64_docker osx_arm64_docker windows_amd64_docker
RBE (See Caveats) linux_amd64 and remote linux_arm64 and remote osx_amd64 and remote osx_arm64 and remote windows_amd64 and remote

Caveats

There are a few caveats to each of these strategies.

  • Local runs require clang compiler and the appropriate cross compilers installed. These runs should only be considered for a power user or user with specific build requirements. See the Dockerfile setup scripts to understand what dependencies must be installed and where.
  • Docker sandbox is slow. Like really slow! The purpose of the docker sandbox is to test RBE builds without deploying a full RBE system. Each build action is executed in its own container. Given the large number of small targets in this project, the overhead of creating docker containers makes this strategy the slowest of all, but requires zero additional setup.
  • Remote Build Execution is by far the fastest, if you have a RBE backend available. This is another advanced use case which will require two config flags above as well as additional flags to specify the --remote_executor. Some of these flags are present in the project .bazelrc with example values, but commented out.