Snap for 7205268 from 52ea3c4bcba48e95b9e52d74772fd5643b239091 to sc-d1-release

Change-Id: Ic974709ae34a9d1484cc510feea4f1baeb979c0d
tree: 2dd17ba331ee8206edad3370bc7d6bc3c7c36e4e
  1. bazel_nojdk-4928295b236ec8f590a7e9d863502bc2f50a77d9-linux-x86_64
  2. OWNERS
  3. README.md
  4. update.sh
README.md

Updating the Bazel prebuilts in AOSP

Instructions

First, decide which version of Bazel you need.

  • A Bazel release (e.g. Bazel 3.7.0)
  • A Bazel nightly
  • A Bazel per-commit build

Whichever of these you use, you will need to use official nojdk x86-64 versions of Bazel, for Linux and macOS (Darwin).

Run the update.sh script in the Linux prebuilts repository to download the and verify the binaries from the trusted Bazel CI pipeline:

./update.sh <commit>

To get the commit hash for builds, see the [Bazel releases], [Bazel nightlies] or [Bazel per-commit builds] sections below.

update.sh will also verify that the downloaded binary has the correct SHA-256 checksum as provided from Bazel CI metadata.

Once you have the binaries, you will need to create and send two CLs, to update the Linux and macOS prebuilts that live in separate Git repositories i.e.

The update script does not automatically create CLs, so you need to create them manually. In the two CLs descriptions, mention the testing you did, which should at least include:

  • For release builds only: Verifying the file signature, e.g.
  • Verifying that Bazel starts, on Linux and on macOS, e.g.
    • source build/envsetup.sh
    • bazel info
  • Verifying basic user journeys succeed.
    • build/bazel/scripts/milestone-2/demo.sh full
    • build/bazel/scripts/milestone-2/demo.sh generate && build/bazel/scripts/milestone-2/demo.sh sync && USE_BAZEL=1 USE_BAZEL_ANALYSIS=1 m libc

Ensure that the Linux and Darwin CLs are set to the same Gerrit topic so they are submitted together.

Obtaining Bazel binaries

The update.sh script automates downloading Bazel binaries. The next sections describe how the different Bazel binaries (release, nightly, per-commit) can be manually downloaded from the Bazel CI.

Bazel releases

The commit hash for linux and darwin nojdk x86-64 binaries are available from https://github.com/bazelbuild/bazel/releases

Bazel nightlies

The commit hash and urls for linux and macOS nojdk x86-64 binaries are available in https://storage.googleapis.com/bazel-builds/metadata/latest.json

Bazel per-commit builds

You need to know the GitHub commit that contains your change, e.g. https://github.com/bazelbuild/bazel/commit/364a867df255c57c8edc4a8aae8f78cb54900a54

And the linux and macOS nojdk x86-64 binaries are available from: