Skip to content

Commit f8ce069

Browse files
authored
repo sync
2 parents 00531de + 327932b commit f8ce069

9 files changed

Lines changed: 76 additions & 74 deletions

content/admin/enterprise-management/upgrading-github-enterprise-server.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,26 @@ versions:
2929

3030
{% endnote %}
3131

32+
{% if currentVersion ver_gt "enterprise-server@2.20" and currentVersion ver_lt "enterprise-server@3.2" %}
33+
34+
### About minimum requirements for {% data variables.product.prodname_ghe_server %} 3.0 and later
35+
36+
Before upgrading to {% data variables.product.prodname_ghe_server %} 3.0 or later, review the hardware resources you've provisioned for your instance. {% data variables.product.prodname_ghe_server %} 3.0 introduces new features such as {% data variables.product.prodname_actions %} and {% data variables.product.prodname_registry %}, and requires more resources than versions 2.22 and earlier. For more information, see the [{% data variables.product.prodname_ghe_server %} 3.0 release notes](/enterprise-server@3.0/admin/release-notes).
37+
38+
Increased requirements for {% data variables.product.prodname_ghe_server %} 3.0 and later are **bold** in the following table.
39+
40+
| User licenses | vCPUs | Memory | Attached storage | Root storage |
41+
| :- | -: | -: | -: | -: |
42+
| Trial, demo, or 10 light users | **4**<br/>_Up from 2_ | **32 GB**<br/>_Up from 16 GB_ | **150 GB**<br/>_Up from 100 GB_ | 200 GB |
43+
| 10 to 3,000 | **8**<br/>_Up from 4_ | **48 GB**<br/>_Up from 32 GB_ | **300 GB**<br/>_Up from 250 GB_ | 200 GB |
44+
| 3,000 to 5000 | **12**<br/>_Up from 8_ | 64 GB | 500 GB | 200 GB |
45+
| 5,000 to 8000 | **16**<br/>_Up from 12_ | 96 GB | 750 GB | 200 GB |
46+
| 8,000 to 10,000+ | **20**<br/>_Up from 16_ | **160 GB**<br/>_Up from 128 GB_ | 1000 GB | 200 GB |
47+
48+
{% data reusables.enterprise_installation.about-adjusting-resources %}
49+
50+
{% endif %}
51+
3252
### Taking a snapshot
3353

3454
A snapshot is a checkpoint of a virtual machine (VM) at a point in time. We highly recommend taking a snapshot before upgrading your virtual machine so that if an upgrade fails, you can revert your VM back to the snapshot. If you're upgrading to a new feature release, you must take a VM snapshot. If you're upgrading to a patch release, you can attach the existing data disk.

content/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server.md

Lines changed: 25 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,26 +9,42 @@ versions:
99
enterprise-server: '>=2.22'
1010
---
1111

12-
{% if currentVersion == "enterprise-server@2.22" %}
13-
{% note %}
14-
15-
**Note:** {% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. Review the external storage requirements below and [sign up for the beta](https://resources.github.com/beta-signup/).
16-
17-
{% endnote %}
18-
{% endif %}
12+
{% data reusables.actions.enterprise-beta %}
1913

2014
{% data reusables.actions.enterprise-github-hosted-runners %}
2115

2216
{% if currentVersion ver_gt "enterprise-server@2.22" %}
2317

2418
This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. It covers the hardware and software requirements, presents the storage options, and describes the security management policies.
2519

20+
{% endif %}
21+
2622
### Review hardware considerations
2723

28-
{% data reusables.actions.enterprise-hardware-considerations %}
24+
{% if currentVersion == "enterprise-server@2.22" or currentVersion == "enterprise-server@3.0" %}
25+
26+
{% note %}
27+
28+
**Note**: {% if currentVersion == "enterprise-server@2.22" %}{% data variables.product.prodname_actions %} was available for {% data variables.product.prodname_ghe_server %} 2.22 as a limited beta. {% endif %}If you're upgrading an existing {% data variables.product.prodname_ghe_server %} instance to 3.0 or later and want to configure {% data variables.product.prodname_actions %}, note that the minimum hardware requirements have increased. For more information, see "[Upgrading {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server#about-minimum-requirements-for-github-enterprise-server-30-and-later)."
29+
30+
{% endnote %}
2931

3032
{% endif %}
3133

34+
{% data reusables.actions.enterprise-hardware-considerations %}
35+
36+
For more information about resource requirements for {% data variables.product.prodname_ghe_server %}, see the hardware considerations for your instance's platform.
37+
38+
- [AWS](/admin/installation/installing-github-enterprise-server-on-aws#hardware-considerations)
39+
- [Azure](/admin/installation/installing-github-enterprise-server-on-azure#hardware-considerations)
40+
- [Google Cloud Platform](/admin/installation/installing-github-enterprise-server-on-google-cloud-platform#hardware-considerations)
41+
- [Hyper-V](/admin/installation/installing-github-enterprise-server-on-hyper-v#hardware-considerations)
42+
- [OpenStack KVM](/admin/installation/installing-github-enterprise-server-on-openstack-kvm#hardware-considerations)
43+
- [VMware](/admin/installation/installing-github-enterprise-server-on-vmware#hardware-considerations)
44+
- [XenServer](/admin/installation/installing-github-enterprise-server-on-xenserver#hardware-considerations)
45+
46+
{% data reusables.enterprise_installation.about-adjusting-resources %}
47+
3248
### External storage requirements
3349

3450
To enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}, you must have access to external blob storage.
@@ -55,7 +71,7 @@ To enable {% data variables.product.prodname_actions %} on {% data variables.pro
5571

5672
### Enabling {% data variables.product.prodname_actions %}
5773

58-
{% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. [Sign up for the beta](https://resources.github.com/beta-signup/).
74+
{% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 was available as a limited beta. To configure {% data variables.product.prodname_actions %} for your instance, upgrade to {% data variables.product.prodname_ghe_server %} 3.0 or later. For more information, see the [{% data variables.product.prodname_ghe_server %} 3.0 release notes](/enterprise-server@3.0/admin/release-notes) and "[Upgrading {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server)."
5975

6076
### Further reading
6177

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,12 @@
11
{% if enterpriseServerVersions contains currentVersion and currentVersion == "enterprise-server@2.22" %}
22
{% note %}
33

4-
**Note:** {% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. To review the external storage requirements and request access to the beta, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}](/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server)."
4+
**Note:** {% data variables.product.prodname_actions %} was available for {% data variables.product.prodname_ghe_server %} 2.22 as a limited beta. The beta has ended. {% data variables.product.prodname_actions %} is now generally available in {% data variables.product.prodname_ghe_server %} 3.0 or later. For more information, see the [{% data variables.product.prodname_ghe_server %} 3.0 release notes](/enterprise-server@3.0/admin/release-notes).
5+
6+
<br/>
7+
8+
- For more information about upgrading to {% data variables.product.prodname_ghe_server %} 3.0 or later, see "[Upgrading {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server)."
9+
- For more information about configuring {% data variables.product.prodname_actions %} after you upgrade, see the [documentation for {% data variables.product.prodname_ghe_server %} 3.0](/enterprise-server@3.0/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server).
510

611
{% endnote %}
712
{% endif %}

data/reusables/actions/enterprise-common-prereqs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
* {% data reusables.actions.enterprise-hardware-considerations %}
1+
* Review the hardware requirements for {% data variables.product.prodname_actions %}. For more information, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}](/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server#review-hardware-considerations)."
22
* TLS must be configured for {% data variables.product.product_location %}'s domain. For more information, see "[Configuring TLS](/admin/configuration/configuring-tls)."
33

44
{% note %}
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
{% data variables.product.prodname_ghe_server %} requires additional CPU and memory resources when {% data variables.product.prodname_actions %} is enabled. Before enabling {% data variables.product.prodname_actions %}, review the "Hardware considerations" for your platform in "[Setting up a {% data variables.product.prodname_ghe_server %} instance](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance)" and ensure that you satisfy the minimum requirements for the features that you want to enable on {% data variables.product.product_location %}.
1+
If you {% if currentVersion == "enterprise-server@2.22" %} configured the beta of{% else %} configure{% endif %} {% data variables.product.prodname_actions %} for the users of your {% data variables.product.prodname_ghe_server %} instance, we recommend that you provision additional CPU and memory resources. The additional resources you need to provision depend on the number of workflows your users run concurrently, and the overall levels of activity for your instance.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
For more information about adjusting resources for an existing instance, see "[Increasing storage capacity](/enterprise/admin/installation/increasing-storage-capacity)" and "[Increasing CPU or memory resources](/enterprise/admin/installation/increasing-cpu-or-memory-resources)."
Lines changed: 3 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,13 @@
1-
{% data variables.product.prodname_ghe_server %} is supported on the following EC2 instance types. For more information, see [the AWS EC2 instance type overview page](http://aws.amazon.com/ec2/instance-types/).
1+
{% data variables.product.prodname_ghe_server %} is supported on the following EC2 instance sizes. For more information, see [the AWS EC2 instance type overview page](http://aws.amazon.com/ec2/instance-types/).
22

3-
| EC2 instance type | Model |
4-
| ----------------- | ----- |
3+
| Type | Size |
4+
| :- | :- |
55
| C3 | c3.2xlarge, c3.4xlarge, c3.8xlarge |
6-
7-
| EC2 instance type | Model |
8-
| ----------------- | ----- |
96
| C4 | c4.2xlarge, c4.4xlarge, c4.8xlarge |
10-
11-
| EC2 instance type | Model |
12-
| ----------------- | ----- |
137
| C5 | c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.18xlarge |
14-
15-
| EC2 instance type | Model |
16-
| ----------------- | ----- |
178
| M3 | m3.xlarge, m3.2xlarge |
18-
19-
| EC2 instance type | Model |
20-
| ----------------- | ----- |
219
| M4 | m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m4.16xlarge |
22-
23-
| EC2 instance type | Model |
24-
| ----------------- | ----- |
2510
| M5 | m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.12xlarge, m5.24xlarge |
26-
27-
| EC2 instance type | Model |
28-
| ----------------- | ----- |
2911
| R4 | r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge |
30-
31-
| EC2 instance type | Model |
32-
| ----------------- | ----- |
3312
| R5 | r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.12xlarge, r5.24xlarge{% if enterpriseServerVersions contains currentVersion and currentVersion ver_gt "enterprise-server@2.19" %}, r5n.large, r5n.xlarge, r5n.2xlarge, r5n.4xlarge, r5n.12xlarge, r5n.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.12xlarge, r5a.24xlarge{% endif %} |
34-
35-
| EC2 instance type | Model |
36-
| ----------------- | ----- |
3713
| X1 | x1.16xlarge, x1.32xlarge |

data/reusables/enterprise_installation/hardware-considerations-all-platforms.md

Lines changed: 4 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,13 @@
11
- [Minimum requirements](#minimum-requirements){% if currentVersion == "enterprise-server@2.22" %}
2-
- [Beta features in {% data variables.product.prodname_ghe_server %} 2.22](#beta-features-in-github-enterprise-server-222){% endif %}{% if currentVersion ver_gt "enterprise-server@2.22" %}
3-
- [Optional features](#optional-features){% endif %}
2+
- [Beta features in {% data variables.product.prodname_ghe_server %} 2.22](#beta-features-in-github-enterprise-server-222){% endif %}
43
- [Storage](#storage)
54
- [CPU and memory](#cpu-and-memory)
65

76
#### Minimum requirements
87

98
We recommend different hardware configurations depending on the number of user licenses for {% data variables.product.product_location %}. If you provision more resources than the minimum requirements, your instance will perform and scale better.
109

11-
{% data reusables.enterprise_installation.hardware-rec-table %}{% if currentVersion ver_gt "enterprise-server@2.21" %} If you enable {% if currentVersion == "enterprise-server@2.22" %}the beta for {% endif %}{% data variables.product.prodname_actions %}, review the following requirements and recommendations.
12-
13-
- You must configure at least one runner for {% data variables.product.prodname_actions %} workflows. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)."
14-
- You must configure external blob storage. For more information, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}](/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server)."
15-
- You may need to configure additional CPU and memory resources. The additional resources you need to provision for {% data variables.product.prodname_actions %} depend on the number of workflows your users run concurrently, and the overall levels of activity for users, automations, and integrations.
16-
17-
| Maximum jobs per minute | Additional vCPUs | Additional memory |
18-
| :- | -: | -: |
19-
| Light testing | 4 | 30.5 GB |
20-
| 25 | 8 | 61 GB |
21-
| 35 | 16 | 122 GB |
22-
| 100 | 32 | 244 GB |
23-
24-
{% endif %}
10+
{% data reusables.enterprise_installation.hardware-rec-table %}
2511

2612
#### Storage
2713

@@ -31,15 +17,15 @@ Your instance requires a persistent data disk separate from the root disk. For m
3117

3218
{% if currentVersion ver_gt "enterprise-server@2.21" %}
3319

34-
If you enable{% if currentVersion == "enterprise-server@2.22" %} the beta of{% endif %} {% data variables.product.prodname_actions %}, you'll need to configure external blob storage. For more information, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}](/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server)."
20+
To configure{% if currentVersion == "enterprise-server@2.22" %} the beta of{% endif %} {% data variables.product.prodname_actions %}, you must provide external blob storage. For more information, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}](/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server)."
3521

3622
{% endif %}
3723

3824
You can resize your instance's root disk by building a new instance or using an existing instance. For more information, see "[Increasing storage capacity](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity)."
3925

4026
#### CPU and memory
4127

42-
{% data variables.product.prodname_ghe_server %} requires more CPU and memory resources depending on levels of activity for users, automations, and integrations.
28+
The CPU and memory resources that {% data variables.product.prodname_ghe_server %} requires depend on the levels of activity for users, automations, and integrations. {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data reusables.actions.enterprise-hardware-considerations %}{% endif %}
4329

4430
{% data reusables.enterprise_installation.increasing-cpus-req %}
4531

0 commit comments

Comments
 (0)