actions / actions/actions-runner-controller

Ability to select runner region in multi‑region high‑availability setup

Open
#4,385 0 comments 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

community enhancement needs triage
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.