Skip to content

Commit 4a06934

Browse files
Update procedures for self-hosted runner groups and public repositories (#16533)
Co-authored-by: Martin Lopes <54248166+martin389@users.noreply.github.com>
1 parent 201a113 commit 4a06934

4 files changed

Lines changed: 34 additions & 6 deletions

File tree

25.2 KB
Loading
10.1 KB
Loading

content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md

Lines changed: 25 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -33,17 +33,27 @@ All organizations have a single default self-hosted runner group. Organizations
3333

3434
Self-hosted runners are automatically assigned to the default group when created, and can only be members of one group at a time. You can move a runner from the default group to any group you create.
3535

36-
When creating a group, you must choose a policy that defines which repositories have access to the runner group. You can configure a runner group to be accessible to a specific list of repositories, all private repositories, or all repositories in the organization.
36+
When creating a group, you must choose a policy that defines which repositories have access to the runner group.
3737

3838
{% data reusables.organizations.navigate-to-org %}
3939
{% data reusables.organizations.org_settings %}
4040
{% data reusables.organizations.settings-sidebar-actions %}
4141
1. In the **Self-hosted runners** section, click **Add new**, and then **New group**.
4242

4343
![Add runner group](/assets/images/help/settings/actions-org-add-runner-group.png)
44-
1. Enter a name for your runner group, and select an access policy from the **Repository access** dropdown list.
44+
1. Enter a name for your runner group, and assign a policy for repository access.
4545

46-
![Add runner group options](/assets/images/help/settings/actions-org-add-runner-group-options.png)
46+
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} You can configure a runner group to be accessible to a specific list of repositories, or to all repositories in the organization. By default, public repositories can't access runners in a runner group, but you can use the **Allow public repositories** option to override this.{% else if currentVersion == "enterprise-server@2.22"%}You can configure a runner group to be accessible to a specific list of repositories, all private repositories, or all repositories in the organization.{% endif %}
47+
48+
{% warning %}
49+
50+
**Warning**
51+
{% indented_data_reference site.data.reusables.github-actions.self-hosted-runner-security spaces=3 %}
52+
For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)."
53+
54+
{% endwarning %}
55+
56+
![Add runner group options](/assets/images/help/settings/actions-org-add-runner-group-options.png)
4757
1. Click **Save group** to create the group and apply the policy.
4858

4959
### Creating a self-hosted runner group for an enterprise
@@ -52,7 +62,7 @@ Enterprises can add their self-hosted runners to groups for access management. E
5262

5363
Self-hosted runners are automatically assigned to the default group when created, and can only be members of one group at a time. You can assign the runner to a specific group during the registration process, or you can later move the runner from the default group to a custom group.
5464

55-
When creating a group, you must choose a policy that grants access to all organizations in the enterprise or choose specific organizations.
65+
When creating a group, you must choose a policy that defines which organizations have access to the runner group.
5666

5767
{% data reusables.enterprise-accounts.access-enterprise %}
5868
{% data reusables.enterprise-accounts.policies-tab %}
@@ -61,7 +71,17 @@ When creating a group, you must choose a policy that grants access to all organi
6171
1. Click **Add new**, and then **New group**.
6272

6373
![Add runner group](/assets/images/help/settings/actions-enterprise-account-add-runner-group.png)
64-
1. Enter a name for your runner group, and select an access policy from the **Organization access** dropdown list.
74+
1. Enter a name for your runner group, and assign a policy for organization access.
75+
76+
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} You can configure a runner group to be accessible to a specific list of organizations, or all organizations in the enterprise. By default, public repositories can't access runners in a runner group, but you can use the **Allow public repositories** option to override this.{% else if currentVersion == "enterprise-server@2.22"%}You can configure a runner group to be accessible to all organizations in the enterprise or choose specific organizations.{% endif %}
77+
78+
{% warning %}
79+
80+
**Warning**
81+
{% indented_data_reference site.data.reusables.github-actions.self-hosted-runner-security spaces=3 %}
82+
For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)."
83+
84+
{% endwarning %}
6585

6686
![Add runner group options](/assets/images/help/settings/actions-enterprise-account-add-runner-group-options.png)
6787
1. Click **Save group** to create the group and apply the policy.
Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,11 @@
11
1. In the **Self-hosted runners** section of the settings page, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} next to the runner group you'd like to configure, then click **Edit name and [organization|repository] access**.
22
![Manage repository permissions](/assets/images/help/settings/actions-runner-manage-permissions.png)
3-
1. Select a new policy from the dropdown list, or modify the runner group name.
3+
1. Modify your policy options, or change the runner group name.
4+
5+
{% warning %}
6+
7+
**Warning**
8+
{% indented_data_reference site.data.reusables.github-actions.self-hosted-runner-security spaces=3 %}
9+
For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)."
10+
11+
{% endwarning %}

0 commit comments

Comments
 (0)