GitHub Actions

Riff provides a GitHub Action called install-riff-action that you can use to install Riff in your CI pipelines. The latest version is v1.

install-riff-action doesn't install Cargo or Nix

In order to leave users free to choose their own installation methods for Cargo or Nix, install-riff-action only installs Riff. The example configuration below shows one potential set of Actions you can use to install them.

Example pipeline

This pipeline configuration installs Cargo, Nix, and Riff and uses Riff to build the local Rust project:

jobs:
  build-release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Install Nix
        uses: cachix/install-nix-action@v17
      - name: Install Rust
        uses: actions-rs/toolchain@v1
        with:
          toolchain: stable
      - name: Install Riff
        uses: DeterminateSystems/install-riff-action@v1
      - name: Build release
        run: riff run cargo build -- --release

Configuration

These configuration parameters are available for install-riff-action:

Parameter	Description	Default
`riff-version`	The Riff version to install	`1.0.3`

This configuration installs a specific version of Riff:

- name: Install Riff v1.0.0
  uses: DeterminateSystems/install-riff-action@v1
  with:
    riff-version: "1.0.0"