runner-fallback-action

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #golang #go #rust #deep-learning #macos #java #awesome #kubernetes #security #open-source

runner-fallback-action

(★ 30)

Github action to determine the availability of self-hosted runners

runner-fallback-action Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Github Runner Fallback Action

**⚠️ Project archived**
This repository is no longer actively maintained. I’m not reviewing or merging pull requests or issues.

If you’re looking for a maintained version, check out this actively updated fork:
**[https://github.com/mikehardy/runner-fallback-action](https://github.com/mikehardy/runner-fallback-action)**

---

Github action to determine the availability of self-hosted runners, and fallback to a GitHub runner if the primary runners are offline.

This action uses [GitHub API](https://docs.github.com/en/rest/actions/self-hosted-runners?apiVersion=2022-11-28#list-self-hosted-runners-for-a-repository) to check the statuses of self hosted-runners that match specific labels, and outputs the runner label(s), or a fallback runner if the self-hosted runner(s) is unavailable.

This output can then used on the `runs-on` property of subsequent jobs.

Note: In order to support an array of labels for the `runs-on` field, the output is formatted as a JSON string and needs to be parsed using `fromJson`. See example usage below.

## Usage

```yaml
jobs:
  # Job to 
  determine-runner:
    runs-on: ubuntu-latest
    outputs:
      runner: ${{ steps.set-runner.outputs.use-runner }}
    steps:
      - name: Determine which runner to use
        id: set-runner
        uses: jimmygchen/runner-fallback-action@v1
        with:
          primary-runner: "self-hosted,linux"
          fallback-runner: "ubuntu-latest"
          github-token: ${{ secrets.YOUR_GITHUB_TOKEN }}

another-job:
    needs: determine-runner
    runs-on: ${{ fromJson(needs.determine-runner.outputs.runner) }}
    steps:
      - name: Do something
        run: echo "Doing something on ${{ needs.determine-runner.outputs.runner }}"
```

Credit: this action is based on the pattern described by @ianpurton on [this feature request thread](https://github.com/orgs/community/discussions/20019#discussioncomment-5414593).

runner-fallback-action

runner-fallback-action Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

runner-fallback-action

runner-fallback-action Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README