Skip to content

BloopAI/sccache-action

Repository files navigation

sccache-action

The sccache action can be used in GitHub Actions workflows to integrate sccache into the build process. The sccache action is a step in a workflow that can be used to cache compilation results for subsequent builds, reducing the build time and speeding up the overall development process.

sccache can easily use GitHub actions cache with almost no configuration.

This action is available on: https://github.com/marketplace/actions/sccache-action

Usage

Just copy and paste the following in your GitHub action:

Use the latest version of sccache if no version is specified

- name: Run sccache-cache uses: mozilla-actions/sccache-action@v0.0.9 

Conditionally run cache and enable it

- name: Run sccache-cache only on non-release runs if: github.event_name != 'release' && github.event_name != 'workflow_dispatch' uses: mozilla-actions/sccache-action@v0.0.9 - name: Set Rust caching env vars only on non-release runs if: github.event_name != 'release' && github.event_name != 'workflow_dispatch' run: | echo "SCCACHE_GHA_ENABLED=true" >> $GITHUB_ENV echo "RUSTC_WRAPPER=sccache" >> $GITHUB_ENV 

Specify a given version of sccache

Versions prior to sccache v0.10.0 probably will not work.

- name: Run sccache-cache uses: mozilla-actions/sccache-action@v0.0.9 with: version: "v0.10.0" 

To get the execution stats

Note that using the previous declaration will automatically create a Post Run sccache-cache task.

- name: Run sccache stat for check shell: bash run: ${SCCACHE_PATH} --show-stats 

disable stats report

- name: Run sccache-cache uses: mozilla-actions/sccache-action with: disable_annotations: true 

Rust code

For Rust code, the following environment variables should be set:

 env: SCCACHE_GHA_ENABLED: "true" RUSTC_WRAPPER: "sccache" 

C/C++ code

For C/C++ code, the following environment variables should be set:

 env: SCCACHE_GHA_ENABLED: "true" 

With cmake, add the following argument:

-DCMAKE_C_COMPILER_LAUNCHER=sccache -DCMAKE_CXX_COMPILER_LAUNCHER=sccache 

With configure, call it with:

# With gcc ./configure CC="sccache gcc" CXX="sccache gcc" # With clang ./configure CC="sccache clang" CXX="sccache clang" 

Using on GitHub Enterprise Server (GHES)

When using the action on GitHub Enterprise Server installations a valid GitHub.com token must be provided.

- name: Run sccache-cache uses: mozilla-actions/sccache-action@v0.0.9 with: token: ${{ secrets.MY_GITHUB_TOKEN }} 

Note that using https://github.com/actions/create-github-app-token is a better option than storing a fixed token in the repo secrets.

Prepare a new release

  1. Update the example in README.md
  2. Update version in package.json
  3. Run npm i --package-lock-only
  4. Run npm run build
  5. Commit and push the local changes
  6. Tag a new release (vX.X.X)
  7. Create a new release in github

License

Apache-2.0 (just like sccache)

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors