lyskdev/Select Runner
Prefer a runner label you choose when at least one matching runner is online; fall back to another label otherwise (common case: self-hosted with a GitHub-hosted fallback). Supports both repo-level and org-level runners.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| preferred-runner-label | Label of the preferred runner (used when at least one online runner has this label) | no | self-hosted |
| fallback | Runner label to use when no online runners match the preferred runner label | no | ubuntu-latest |
| token | GitHub token used to query the repo-level Actions API (needs actions:read permission). This is used to check for repo-level runners. Defaults to the automatic workflow token. | no | ${{ github.token }} |
| runner-token | GitHub token with org-level runner read access. When provided, the action also checks org-level runners if no repo-level runners match. Create a fine-grained PAT with "Organization self hosted runners: Read" permission, or a classic PAT with admin:org scope. Not required when runners are registered at the repo level. | no | "" |
Outputs
| name | description |
|---|---|
| runner | Resolved runner label to pass to runs-on |