Skip to content

Commit 23e4f98

Browse files
authored
EDI-ify "Using self-hosted runners in a workflow" (#56728)
1 parent 5f872b7 commit 23e4f98

File tree

2 files changed

+9
-35
lines changed

2 files changed

+9
-35
lines changed

content/actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow.md

Lines changed: 0 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -14,28 +14,6 @@ type: tutorial
1414
shortTitle: Use runners in a workflow
1515
---
1616

17-
{% data reusables.actions.enterprise-github-hosted-runners %}
18-
19-
You can target self-hosted runners for use in a workflow based on the labels assigned to the runners, or their group membership, or a combination of these.
20-
21-
>[!IMPORTANT]Runner Scale Sets do not support multiple labels, only the name of the runner can be used in place of a label. See [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller).
22-
23-
## About self-hosted runner labels
24-
25-
Labels allow you to send workflow jobs to specific types of self-hosted runners, based on their shared characteristics. For example, if your job requires a particular hardware component or software package, you can assign a custom label to a runner and then configure your job to only execute on runners with that label.
26-
27-
{% data reusables.actions.self-hosted-runner-labels-runs-on %}
28-
29-
For information on creating custom and default labels, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/using-labels-with-self-hosted-runners).
30-
31-
## About self-hosted runner groups
32-
33-
For self-hosted runners defined at the organization {% ifversion ghec or ghes %}or enterprise levels{% else %}level{% endif %}, you can group your runners with shared characteristics into a single runner group and then configure your job to target the runner group.
34-
35-
To specify a self-hosted runner group for your job, configure `runs-on.group` in your workflow file.
36-
37-
For information on creating and managing runner groups, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups).
38-
3917
{% ifversion repository-actions-runners %}
4018

4119
## Viewing available runners for a repository
@@ -99,16 +77,3 @@ These labels operate cumulatively, so a self-hosted runner must have all four la
9977
## Using labels and groups to route jobs
10078

10179
{% data reusables.actions.jobs.example-runs-on-labels-and-groups %}
102-
103-
## Routing precedence for self-hosted runners
104-
105-
When routing a job to a self-hosted runner, {% data variables.product.prodname_dotcom %} looks for a runner that matches the job's `runs-on` labels and groups:
106-
107-
* If {% data variables.product.prodname_dotcom %} finds an online and idle runner that matches the job's `runs-on` labels and groups, the job is then assigned and sent to the runner.
108-
* If the runner doesn't pick up the assigned job within 60 seconds, the job is re-queued so that a new runner can accept it.
109-
* If {% data variables.product.prodname_dotcom %} doesn't find an online and idle runner that matches the job's `runs-on` labels and groups, then the job will remain queued until a runner comes online.
110-
* If the job remains queued for more than 24 hours, the job will fail.
111-
112-
## Workflow run continuity
113-
114-
{% data reusables.actions.runner-workflow-continuity %}

content/actions/reference/self-hosted-runners-reference.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,15 @@ You can use a machine as a self-hosted runner as long as it meets these requirem
5858
* `ARM64` - Linux, macOS{% ifversion actions-windows-arm %}, Windows (currently in {% data variables.release-phases.public_preview %}){% endif %}.
5959
* `ARM32` - Linux.
6060

61+
## Routing precedence for self-hosted runners
62+
63+
When routing a job to a self-hosted runner, {% data variables.product.prodname_dotcom %} looks for a runner that matches the job's `runs-on` labels and groups:
64+
65+
* If {% data variables.product.prodname_dotcom %} finds an online and idle runner that matches the job's `runs-on` labels and groups, the job is then assigned and sent to the runner.
66+
* If the runner doesn't pick up the assigned job within 60 seconds, the job is re-queued so that a new runner can accept it.
67+
* If {% data variables.product.prodname_dotcom %} doesn't find an online and idle runner that matches the job's `runs-on` labels and groups, then the job will remain queued until a runner comes online.
68+
* If the job remains queued for more than 24 hours, the job will fail.
69+
6170
## Autoscaling
6271

6372
You can automatically increase or decrease the number of self-hosted runners in your environment in response to the webhook events you receive with a particular label.

0 commit comments

Comments
 (0)