Skip to content

Commit 8310639

Browse files
authored
EDI-ify About self-hosted runners + Supported architectures and operating systems for self-hosted runners (#56510)
1 parent c02b470 commit 8310639

File tree

4 files changed

+64
-70
lines changed

4 files changed

+64
-70
lines changed
Lines changed: 8 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: About self-hosted runners
3+
shortTitle: Self-hosted runners
34
intro: 'You can host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows.'
45
redirect_from:
56
- /github/automating-your-workflow-with-github-actions/about-self-hosted-runners
@@ -13,14 +14,12 @@ versions:
1314
type: overview
1415
---
1516

16-
## About self-hosted runners
17-
1817
A self-hosted runner is a system that you deploy and manage to execute jobs from {% data variables.product.prodname_actions %} on {% data variables.product.github %}.
1918

2019
Self-hosted runners:
2120

2221
{% ifversion fpt or ghec %}
23-
* Give you more control of hardware, operating system, and software tools than {% data variables.product.prodname_dotcom %}-hosted runners provide.{% endif %}
22+
* Give you more control of hardware, operating system, and software tools than {% data variables.product.prodname_dotcom %}-hosted runners provide. Be aware that you are responsible for updating the operating system and all other software.{% endif %}
2423
* Are free to use with {% data variables.product.prodname_actions %}, but you are responsible for the cost of maintaining your runner machines.
2524
* Let you create custom hardware configurations that meet your needs with processing power or memory to run larger jobs, install software available on your local network.
2625
* Receive automatic updates for the self-hosted runner application only, though you may disable automatic updates of the runner.
@@ -31,30 +30,12 @@ Self-hosted runners:
3130

3231
You can use self-hosted runners anywhere in the management hierarchy. Repository-level runners are dedicated to a single repository, while organization-level runners can process jobs for multiple repositories in an organization. Organization owners can choose which repositories are allowed to create repository-level self-hosted runners. See [AUTOTITLE](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#limiting-the-use-of-self-hosted-runners). Finally, enterprise-level runners can be assigned to multiple organizations in an enterprise account.
3332

34-
### Requirements for self-hosted runner machines
35-
36-
You can use any machine as a self-hosted runner as long as it meets these requirements:
37-
38-
* You can install and run the self-hosted runner application on the machine.
39-
* The machine can communicate with {% data variables.product.prodname_actions %}.
40-
* The machine has enough hardware resources for the type of workflows you plan to run. The self-hosted runner application itself only requires minimal resources.
41-
* If you want to run workflows that use Docker container actions or service containers, you must use a Linux machine and Docker must be installed.
42-
43-
{% ifversion ghes %}
44-
45-
## Supported actions on self-hosted runners
46-
47-
All `actions/setup-LANGUAGE` action repositories currently support three platforms: macOS, Windows, and Ubuntu.
48-
Some extra configuration might be required to use actions from {% data variables.product.github %} with {% data variables.product.prodname_ghe_server %}, or to use the `actions/setup-LANGUAGE` actions with self-hosted runners that do not have internet access. For more information, see [AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom) and contact your {% data variables.product.prodname_enterprise %} site administrator.
33+
## Next steps
4934

35+
{% ifversion ghec or ghes %}
36+
To get hands-on experience with the policies and usage of self-hosted runners, see [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise)
37+
{% else %}
38+
To set up a self-hosted runner in your workspace, see [AUTOTITLE](/actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners).
5039
{% endif %}
5140

52-
## Further reading
53-
54-
* [AUTOTITLE](/actions/security-for-github-actions/security-guides/security-hardening-for-github-actions)
55-
* [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners)
56-
* [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow)
57-
* [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/autoscaling-with-self-hosted-runners){% ifversion ghec or ghes %}
58-
* [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise){% endif %}
59-
* [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/supported-architectures-and-operating-systems-for-self-hosted-runners)
60-
* [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/communicating-with-self-hosted-runners)
41+
To find information about the requirements and supported software and hardware for self-hosted runners, see [AUTOTITLE](/actions/reference/self-hosted-runners-reference).

content/actions/reference/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,8 @@ children:
1818
- /actions-limits
1919
- /dockerfile-support-for-github-actions
2020
- /github-hosted-runners-reference
21-
- /supported-architectures-and-operating-systems-for-self-hosted-runners
21+
- /self-hosted-runners-reference
2222
- /usage-limits-for-self-hosted-runners
2323
- /supplemental-arguments-and-settings
2424
---
25+
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
title: Self-hosted runners reference
3+
shortTitle: Self-hosted runners reference
4+
intro: Find information about requirements and supported actions for self-hosted runners.
5+
redirect_from:
6+
- /actions/hosting-your-own-runners/managing-self-hosted-runners/supported-architectures-and-operating-systems-for-self-hosted-runners
7+
- /actions/reference/supported-architectures-and-operating-systems-for-self-hosted-runners
8+
versions:
9+
fpt: '*'
10+
ghes: '*'
11+
ghec: '*'
12+
type: overview
13+
---
14+
15+
## Requirements for self-hosted runner machines
16+
17+
You can use a machine as a self-hosted runner as long as it meets these requirements:
18+
19+
* You can install and run the self-hosted runner application on the machine. See [Supported operating systems](#supported-operating-systems) and [Supported processor architectures](#supported-processor-architectures).
20+
* The machine can communicate with {% data variables.product.prodname_actions %}.
21+
* The machine has enough hardware resources for the type of workflows you plan to run. The self-hosted runner application itself only requires minimal resources.
22+
* If you want to run workflows that use Docker container actions or service containers, you must use a Linux machine and Docker must be installed.
23+
24+
### Supported operating systems
25+
26+
#### Linux
27+
28+
* Red Hat Enterprise Linux 8 or later
29+
* CentOS 8 or later
30+
* Oracle Linux 8 or later
31+
* Fedora 29 or later
32+
* Debian 10 or later
33+
* Ubuntu 20.04 or later
34+
* Linux Mint 20 or later
35+
* openSUSE 15.2 or later
36+
* SUSE Enterprise Linux (SLES) 15 SP2 or later
37+
38+
#### Windows
39+
40+
* Windows 10 64-bit
41+
* Windows 11 64-bit
42+
* Windows Server 2016 64-bit
43+
* Windows Server 2019 64-bit
44+
* Windows Server 2022 64-bit
45+
46+
#### macOS
47+
48+
* macOS 11.0 (Big Sur) or later
49+
50+
### Supported processor architectures
51+
52+
* `x64` - Linux, macOS, Windows.
53+
* `ARM64` - Linux, macOS{% ifversion actions-windows-arm %}, Windows (currently in {% data variables.release-phases.public_preview %}){% endif %}.
54+
* `ARM32` - Linux.

content/actions/reference/supported-architectures-and-operating-systems-for-self-hosted-runners.md

Lines changed: 0 additions & 42 deletions
This file was deleted.

0 commit comments

Comments
 (0)