Skip to content

Commit 5933365

Browse files
lucascostiEdward ThomsonSarah Edwards
authored
Clarify wording for runs-on syntax (#12504)
Co-authored-by: Edward Thomson <ethomson@github.com> Co-authored-by: Sarah Edwards <skedwards88@github.com>
1 parent bee380f commit 5933365

2 files changed

Lines changed: 4 additions & 2 deletions

File tree

content/actions/learn-github-actions/workflow-syntax-for-github-actions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -465,7 +465,7 @@ In this example, `job3` uses the `always()` conditional expression so that it al
465465

466466
## `jobs.<job_id>.runs-on`
467467

468-
**Required**. The type of machine to run the job on. The machine can be either a {% data variables.product.prodname_dotcom %}-hosted runner or a self-hosted runner.
468+
**Required**. The type of machine to run the job on. The machine can be either a {% data variables.product.prodname_dotcom %}-hosted runner or a self-hosted runner. You can provide `runs-on` as a single string or as an array of strings.
469469

470470
{% ifversion ghae %}
471471
### {% data variables.actions.hosted_runner %}s
Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
11
To specify a self-hosted runner for your job, configure `runs-on` in your workflow file with self-hosted runner labels.
22

3-
All self-hosted runners have the `self-hosted` label. Using only this label will select any self-hosted runner. To select runners that meet certain criteria, such as operating system or architecture, provide an array of labels that begins with `self-hosted` (this must be listed first) and then includes additional labels as needed.
3+
All self-hosted runners have the `self-hosted` label. Using only this label will select any self-hosted runner. To select runners that meet certain criteria, such as operating system or architecture, we recommend providing an array of labels that begins with `self-hosted` (this must be listed first) and then includes additional labels as needed. When you specify an array of labels, jobs will be queued on runners that have all the labels that you specify.
4+
5+
Although the `self-hosted` label is not required, we strongly recommend specifying it when using self-hosted runners to ensure that your job does not unintentionally specify any current or future {% data variables.product.prodname_dotcom %}-hosted runners.

0 commit comments

Comments
 (0)