bazel-contrib/setup-bazel
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
Mirror of bazel-contrib/setup-bazel for self-hosted Forgejo Actions
96 commits 7 branches 28 tags 12 MiB
Find a file
github-actions 663f88d97a Release 0.13.0
2025-01-24 22:04:41 +00:00
.github/workflows Fix release workflow tag creation 2024-05-20 13:44:06 -07:00
dist Release 0.13.0 2025-01-24 22:04:41 +00:00
.gitignore Hello world 2023-01-04 16:31:00 -08:00
.tool-versions Update Node.js to v22.13.1 (#63) 2025-01-21 13:21:18 -08:00
action.yml Allow changing output base path 2024-12-20 16:28:37 -08:00
config.js Include repository cache files in the disk cache key. (#64) 2025-01-24 14:03:38 -08:00
index.js Fix regression with missing token 2025-01-07 14:25:12 -08:00
LICENSE Initial commit 2023-01-04 16:27:56 -08:00
package-lock.json Release 0.13.0 2025-01-24 22:04:41 +00:00
package.json Release 0.13.0 2025-01-24 22:04:41 +00:00
post.js Add a process.exit after storing caches (#37) 2024-09-23 12:50:02 -07:00
README.md Release 0.13.0 2025-01-24 22:04:41 +00:00
renovate.json Add renovate.json (#3) 2024-03-09 11:06:24 -08:00
util.js Fix regression in gathering folder size 2023-11-26 17:11:31 -08:00

README.md

setup-bazel

This action allows to properly configure Bazelisk and Bazel on all operating systems and provides an advanced fine-grained caching to improve workflows performance.

Usage

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    # Avoid downloading Bazel every time.
    bazelisk-cache: true
    # Store build cache per workflow.
    disk-cache: ${{ github.workflow }}
    # Share repository cache between workflows.
    repository-cache: true

Inputs

bazelisk-cache

Cache bazelisk downloads based on contents of a .bazelversion file.

Default false.

bazelisk-version

bazelisk version to download and use.

Supports semver specification and ranges. Leave empty to use pre-installed Bazelisk.

Default "".

Examples

Install Bazelisk 1.x

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    bazelisk-version: 1.x

Install exact Bazelisk version

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    bazelisk-version: 1.19.0

bazelrc

Extra contents to write to a user's bazelrc file.

You can use multiline YAML strings.

Default "".

Examples

Enable Bzlmod

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    bazelrc: common --enable_bzlmod

Add colors and timestamps

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    bazelrc: |
      build --color=yes
      build --show_timestamps

disk-cache

Enable disk_cache and store it on GitHub based on contents of BUILD files.

You can also pass a string to use as a cache key to separate caches from different workflows.

Default false.

Examples

Share a single disk cache

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    disk-cache: true

Separate disk caches between workflows

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    disk-cache: ${{ github.workflow }}}

external-cache

Cache external/ repositories based on contents of MODULE.bazel and WORKSPACE files. Only repositories exceeding 10MB are being cached. Each repository is stored in a separate cache.

You can also pass a manifest object where key is the name of the external repository and value is a file (or list of files) which contents are used to calculate cache key. If the value is false, the external repository won't be cached.

Default false.

Examples

Enable external repositories caches

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    external-cache: true

Cache NPM repositories based on package-lock.json contents

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    external-cache: |
      manifest:
        npm: package-lock.json

Do not cache Ruby on Windows

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    external-cache: |
      manifest:
        ruby: ${{ runner.os == 'Windows' && 'false' || 'true' }}

google-credentials

Google Cloud account key to use for remote caching authentication.

Default "".

Examples

Authenticate via key

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    google-credentials: ${{ secrets.GOOGLE_CLOUD_KEY }}

output-base

Change Bazel output base directory.

You might want to change it when running on self-hosted runners with a custom directory layout.

Default is one of the following:

  • $HOME/.bazel on Linux and macOS
  • D:/_bazel on Windows
Examples

Use C drive letter

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    output-base: C:/_bazel

repository-cache

Enable repository_cache and store it on GitHub based on contents of MODULE.bazel and WORKSPACE files.

You can also pass a file (or list of files) which contents are used to calculate cache key.

Default false.

Examples

Store a single repository cache

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    repository-cache: true

Store a repository cache from a custom location

- uses: bazel-contrib/setup-bazel@0.13.0
  with:
    repository-cache: examples/gem/WORKSPACE

Migrating from bazelbuild/setup-bazelisk

You can simply replace bazelbuild/setup-bazelisk action with bazel-contrib/setup-bazel. However, if you used a bazel-version input before, you will need to remove it in favor other ways to specify Bazel version.

Development

To build action, run the following command:

$ npm run build

Release

Use Release workflow to cut a new release.