Skip to content

Commit b6deeff

Browse files
committed
Merge branch 'main' of github.com:github/docs-internal into create-graphql-files-for-new-version
2 parents 838f770 + a05a363 commit b6deeff

File tree

87 files changed

+583
-266
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

87 files changed

+583
-266
lines changed
38.1 KB
Loading
19 KB
Loading
16.6 KB
Loading
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 "[email protected]" %} 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 == "[email protected]"%}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 "[email protected]" %} 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 == "[email protected]"%}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.

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

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -876,6 +876,37 @@ strategy:
876876

877877
{% endnote %}
878878

879+
##### Using environment variables in a matrix
880+
881+
You can add custom environment variables for each test combination by using `include` with `env`. You can then refer to the custom environment variables in a later step.
882+
883+
In this example, the matrix entries for `node-version` are each configured to use different values for the `site` and `datacenter` environment variables. The `Echo site details` step then uses {% raw %}`env: ${{ matrix.env }}`{% endraw %} to refer to the custom variables:
884+
885+
{% raw %}
886+
```yaml
887+
name: Node.js CI
888+
on: [push]
889+
jobs:
890+
build:
891+
runs-on: ubuntu-latest
892+
strategy:
893+
matrix:
894+
include:
895+
- node-version: 10.x
896+
site: "prod"
897+
datacenter: "site-a"
898+
- node-version: 12.x
899+
site: "dev"
900+
datacenter: "site-b"
901+
steps:
902+
- name: Echo site details
903+
env:
904+
SITE: ${{ matrix.site }}
905+
DATACENTER: ${{ matrix.datacenter }}
906+
run: echo $SITE $DATACENTER
907+
```
908+
{% endraw %}
909+
879910
### **`jobs.<job_id>.strategy.fail-fast`**
880911

881912
When set to `true`, {% data variables.product.prodname_dotcom %} cancels all in-progress jobs if any `matrix` job fails. Default: `true`

content/admin/enterprise-management/increasing-storage-capacity.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,8 @@ As more users join {% data variables.product.product_location %}, you may need t
2020

2121
{% endnote %}
2222

23+
#### Minimum requirements
24+
2325
{% data reusables.enterprise_installation.hardware-rec-table %}
2426

2527
### Increasing the data partition size
Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,31 @@
11
---
22
title: About enterprise accounts
3-
intro: 'With {% data variables.product.prodname_ghe_server %}, you can create an enterprise account to give administrators a single point of visibility and management for their billing and license usage.'
3+
intro: 'With {% data variables.product.product_name %}, you can use an enterprise account to give administrators a single point of visibility and management{% if enterpriseServerVersions contains currentVersion %} for billing and license usage{% endif %}.'
44
redirect_from:
55
- /enterprise/admin/installation/about-enterprise-accounts
66
- /enterprise/admin/overview/about-enterprise-accounts
77
versions:
8-
enterprise-server: '*'
8+
enterprise-server: '>=2.20'
9+
github-ae: '*'
910
---
1011

11-
### About enterprise accounts on {% data variables.product.prodname_ghe_server %}
12+
### About enterprise accounts on {% data variables.product.product_name %}
1213

13-
An enterprise account allows you to manage multiple {% data variables.product.prodname_dotcom %} organizations and {% data variables.product.prodname_ghe_server %} instances. Your enterprise account must have a handle, like an organization or personal account on {% data variables.product.prodname_dotcom %}. Enterprise administrators can manage settings and preferences, like:
14+
An enterprise account allows you to manage multiple organizations{% if enterpriseServerVersions contains currentVersion %} and {% data variables.product.prodname_ghe_server %} instances{% else %} on {% data variables.product.product_name %}{% endif %}. Your enterprise account must have a handle, like an organization or personal account on {% data variables.product.prodname_dotcom %}. Enterprise administrators can manage settings and preferences, like:
1415

15-
- Member access and management (organization members, outside collaborators)
16-
- Billing and usage ({% data variables.product.prodname_ghe_server %} instances, user licenses, {% data variables.large_files.product_name_short %} packs)
17-
- Security (single sign-on, two factor authentication)
18-
- Requests and support bundle sharing with {% data variables.contact.enterprise_support %}
16+
- Member access and management (organization members, outside collaborators){% if enterpriseServerVersions contains currentVersion %}
17+
- Billing and usage ({% data variables.product.prodname_ghe_server %} instances, user licenses, {% data variables.large_files.product_name_short %} packs){% endif %}
18+
- Security{% if enterpriseServerVersions contains currentVersion %}(single sign-on, two factor authentication)
19+
- Requests {% if enterpriseServerVersions contains currentVersion %}and support bundle sharing {% endif %}with {% data variables.contact.enterprise_support %}{% endif %}
1920

20-
{% data reusables.enterprise-accounts.enterprise-accounts-billing %}
21+
{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about managing your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)."
22+
23+
{% if enterpriseServerVersions contains currentVersion %}
2124

2225
For more information about the differences between {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/githubs-products)." To upgrade to {% data variables.product.prodname_enterprise %} or to get started with an enterprise account, contact {% data variables.contact.contact_enterprise_sales %}.
2326

2427
### Managing {% data variables.product.prodname_ghe_server %} licenses linked to your enterprise account
2528

2629
{% data reusables.enterprise-accounts.admin-managing-licenses %}
30+
31+
{% endif %}

content/admin/policies/enforcing-repository-management-policies-in-your-enterprise.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ versions:
3434

3535
Each time someone creates a new repository on your enterprise, that person must choose a visibility for the repository. When you configure a default visibility setting for the enterprise, you choose which visibility is selected by default. For more information on repository visibility, see "[About repository visibility](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)."
3636

37-
If a site administrator disallows members from creating certain types of repositories, members will not be able to create that type of repository even if the visibility setting defaults to that type. For more information, see "[Setting a policy for repository creation](#setting-a-policy-for-repository-creation)."
37+
If an enterprise owner disallows members from creating certain types of repositories, members will not be able to create that type of repository even if the visibility setting defaults to that type. For more information, see "[Setting a policy for repository creation](#setting-a-policy-for-repository-creation)."
3838

3939
{% data reusables.enterprise-accounts.access-enterprise %}
4040
{% if currentVersion ver_gt "[email protected]" or currentVersion == "github-ae@latest" %}
@@ -50,9 +50,9 @@ If a site administrator disallows members from creating certain types of reposit
5050

5151
### Setting a policy for changing a repository's visibility
5252

53-
When you prevent members from changing repository visibility, only site administrators have the ability to make public repositories private or make private repositories public.
53+
When you prevent members from changing repository visibility, only enterprise owners can change the visibility of a repository.
5454

55-
If a site administrator has restricted repository creation to organization owners only, then members will not be able to change repository visibility. If a site administrator has restricted member repository creation to private repositories only, then members will only be able to change repositories from public to private. For more information, see "[Setting a policy for repository creation](#setting-a-policy-for-repository-creation)."
55+
If an enterprise owner has restricted repository creation to organization owners only, then members will not be able to change repository visibility. If an enterprise owner has restricted member repository creation to private repositories only, then members will only be able to change the visibility of a repository to private. For more information, see "[Setting a policy for repository creation](#setting-a-policy-for-repository-creation)."
5656

5757
{% data reusables.enterprise-accounts.access-enterprise %}
5858
{% data reusables.enterprise-accounts.policies-tab %}
@@ -77,6 +77,16 @@ If a site administrator has restricted repository creation to organization owner
7777
![Drop-down menu with repository creation policies](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png)
7878
{% endif %}
7979

80+
### Enforcing a policy on forking private or internal repositories
81+
82+
Across all organizations owned by your enterprise, you can allow people with access to a private or internal repository to fork the repository, never allow forking of private or internal repositories, or allow owners to administer the setting on the organization level.
83+
84+
{% data reusables.enterprise-accounts.access-enterprise %}
85+
{% data reusables.enterprise-accounts.policies-tab %}
86+
3. On the **Repository policies** tab, under "Repository forking", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %}
87+
4. Under "Repository forking", use the drop-down menu and choose a policy.
88+
![Drop-down menu with repository forking policy options](/assets/images/help/business-accounts/repository-forking-policy-drop-down.png)
89+
8090
### Setting a policy for repository deletion and transfer
8191

8292
{% data reusables.enterprise-accounts.access-enterprise %}
@@ -175,6 +185,8 @@ You can override the default inherited settings by configuring the settings for
175185
6. Optionally, select **Enforce on all repositories** to override repository-specific settings. Note that this will **not** override an enterprise-wide policy.
176186
![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png)
177187

188+
{% if enterpriseServerVersions contains currentVersion %}
189+
178190
### Configuring anonymous Git read access
179191

180192
{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %}
@@ -203,7 +215,6 @@ If necessary, you can prevent repository administrators from changing anonymous
203215
3. Optionally, to prevent repository admins from changing anonymous Git read access settings in all repositories on your enterprise, select **Prevent repository admins from changing anonymous Git read access**.
204216
![Select checkbox to prevent repository admins from changing anonymous Git read access settings for all repositories on your enterprise](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png)
205217

206-
{% if enterpriseServerVersions contains currentVersion %}
207218
#### Setting anonymous Git read access for a specific repository
208219

209220
{% data reusables.enterprise_site_admin_settings.access-settings %}
@@ -217,6 +228,7 @@ If necessary, you can prevent repository administrators from changing anonymous
217228
![Confirm anonymous Git read access setting in pop-up window](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png)
218229
8. Optionally, to prevent repository admins from changing this setting for this repository, select **Prevent repository admins from changing anonymous Git read access**.
219230
![Select checkbox to prevent repository admins from changing anonymous Git read access for this repository](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png)
231+
220232
{% endif %}
221233

222234
{% if currentVersion ver_gt "[email protected]" or currentVersion == "github-ae@latest" %}

0 commit comments

Comments
 (0)