actions / actions/actions-runner-controller
Ability to select runner region in multi‑region high‑availability setup
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 6.5k
- Forks
- 1.5k
- Avg merge
- 2d 2h
- Merged PRs (30d)
- 27
Description
What would you like added?
We would like a way to select or target the region of a self‑hosted runner when using a multi‑region high‑availability setup (as described in https://github.com/actions/actions-runner-controller/issues/4283).
Currently, runners across regions share the same scale set name for HA purposes, and we don’t have a method to apply additional labels that would differentiate runners by region. A mechanism to specify runner region in workflow configuration - or a supported pattern to assign region-specific labels - would allow us to direct certain workflows to a specific region when necessary.
Why is this needed?
Although most of our workflows perform equally well regardless of runner region, there are a few specific cases where the execution region has a measurable impact.
We explored using scale set names or custom labels, but the HA design requires identical scale set names across regions, and we do not currently have a supported way to apply region‑unique labels. As a result, there is no current method for our workflows to choose the region of the underlying runner.
Additional context
We have successfully implemented multi‑region runner high availability and it works extremely well. The only missing capability is region targeting for a subset of specialized workflows.
Any guidance or recommended patterns would be greatly appreciated.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading the linked actions-runner-controller issue #4283 and the repository's existing multi-region high-availability and runner-label behavior. Define a supported way for workflows to target a region or for runners to receive region-specific labels, then verify that the approach preserves the shared scale set name required for HA.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github-actions, go, kubernetes
- Domain
- ci-cd, devops, infrastructure
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 30/100