Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 4298626

Browse files
sophiethekingerikaxulecoursenisaacmbrown
authored
metered GHE/GHAS Offering - [GA] (#51647)
Co-authored-by: erikaxu <[email protected]> Co-authored-by: Laura Coursen <[email protected]> Co-authored-by: Isaac Brown <[email protected]>
1 parent 89f5ce8 commit 4298626

31 files changed

Lines changed: 267 additions & 83 deletions

File tree

‎content/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users.md‎

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -21,12 +21,7 @@ Before your developers can use {% data variables.product.prodname_ghe_cloud %} w
2121

2222
To use {% data variables.product.prodname_emus %}, you need a **separate type of enterprise account** with {% data variables.product.prodname_emus %} enabled.
2323

24-
To request a new enterprise account, contact [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact). You'll discuss options for trialing {% data variables.product.prodname_emus %} or migrating from an existing enterprise.
25-
26-
When you're ready, your contact on the {% data variables.product.prodname_dotcom %} Sales team will create your new {% data variables.enterprise.prodname_emu_enterprise %}. You'll be asked to provide the following information:
27-
28-
* The **email address** for the user who will set up your enterprise.
29-
* A **short code** that will be used as the suffix for your enterprise members' usernames. {% data reusables.enterprise-accounts.emu-shortcode %}
24+
Start a free 30-day trial of {% data variables.product.prodname_ghe_cloud %}, and choose **Enterprise with managed users**. See "[AUTOTITLE](/admin/overview/setting-up-a-trial-of-github-enterprise-cloud)."
3025

3126
## Create the setup user
3227

‎content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,6 @@ In most cases, you can create an enterprise account **yourself**.
3030

3131
You'll **need help** creating an enterprise account for:
3232

33-
* {% data variables.product.prodname_emus %}
3433
* {% data variables.product.prodname_ghe_server %}
3534
* Invoicing
3635

‎content/admin/overview/about-github-enterprise-cloud.md‎

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -27,14 +27,7 @@ A key difference between {% data variables.product.product_name %} and other {%
2727

2828
{% data reusables.enterprise.ghe-includes-ghec-and-ghes %} For more information about {% data variables.product.prodname_ghe_server %} and how it differs from {% data variables.product.prodname_ghe_cloud %}, see "[AUTOTITLE](/admin/overview/about-github-for-enterprises#about-deployment-options)."
2929

30-
## About enterprise types
31-
32-
**Before** starting with {% data variables.product.prodname_ghe_cloud %}, you must choose an enterprise type.
33-
34-
* Enterprise with personal accounts
35-
* Enterprise with managed users
36-
37-
To help you decide which choice is best for your enterprise, see "[AUTOTITLE](/admin/identity-and-access-management/understanding-iam-for-enterprises/choosing-an-enterprise-type-for-github-enterprise-cloud)."
30+
{% data reusables.enterprise.enterprise-types %}
3831

3932
## About documentation
4033

‎content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md‎

Lines changed: 11 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -24,36 +24,28 @@ To set up a trial, you must be signed in to a personal account. If you don't hav
2424

2525
You do not need to provide a payment method during the trial.
2626

27-
## Is the trial right for me?
28-
29-
The self-serve trial **is not** right for you if your company:
30-
31-
* Wants to try {% data variables.product.prodname_emus %}
32-
* Wants to try {% data variables.product.prodname_ghe_server %} alongside {% data variables.product.prodname_ghe_cloud %}
33-
* Has a Microsoft Enterprise Agreement
34-
* Needs to connect an Azure subscription to the enterprise during the trial
35-
36-
If any of these apply and you want to set up a trial, **contact [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact)**.
27+
{% data reusables.enterprise.enterprise-types %}
3728

3829
## What is included in the trial?
3930

4031
The trial lasts for **{% data reusables.enterprise.ghec-trial-length %} days** and includes the following features.
4132

42-
* Access to **most** {% data variables.product.prodname_ghe_cloud %} features.
33+
* Access to **most** {% data variables.product.prodname_ghe_cloud %} features.{% ifversion metered-ghe-ghas%}
34+
* Access to the **enhanced billing platform**. See "[AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises/about-the-enhanced-billing-platform-for-enterprises)."{% endif %}
4335
* An **enterprise account**, which allows you to manage multiple organizations. See "[AUTOTITLE](/enterprise-cloud@latest/get-started/learning-about-github/types-of-github-accounts)."
4436
* Up to **50 seats** to grant access to users.
4537
* The option to set up a free trial of **{% data variables.product.prodname_GH_advanced_security %}** to test features such as {% data variables.product.prodname_code_scanning %} and {% data variables.product.prodname_secret_scanning %}. See "[AUTOTITLE](/enterprise-cloud@latest/billing/managing-billing-for-github-advanced-security/setting-up-a-trial-of-github-advanced-security)."
4638

4739
## Features not included in the trial
4840

49-
* {% data variables.product.prodname_emus %}
41+
* {% data variables.product.prodname_ghe_server %}
5042
* {% data variables.product.prodname_github_codespaces %}
5143
* {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}
5244
* {% data variables.product.prodname_sponsors %}
5345
* Paid {% data variables.product.prodname_marketplace %} apps
5446
* {% data variables.product.prodname_github_connect %}
5547
* {% data variables.large_files.product_name_long %}
56-
* For {% data variables.product.prodname_actions %}, increased minutes, job concurrency, and {% data variables.actions.hosted_runner %}s
48+
* For {% data variables.product.prodname_actions %}, increased minutes, job concurrency, and {% data variables.actions.hosted_runners %}
5749

5850
If you invite an existing organization into your trial enterprise, **all of these features will be disabled**. If you remove the organization from the enterprise, the features will be re-enabled.
5951

@@ -73,8 +65,12 @@ You can end your trial at any time by purchasing {% data variables.product.prodn
7365

7466
If you **purchase {% data variables.product.prodname_enterprise %}**:
7567

76-
* You'll now be charged for each unique user in your enterprise.
77-
* You can add more seats to your subscription, up to 1,000.
68+
{% ifversion metered-ghe-ghas%}
69+
* You can use usage-based billing for {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_GH_advanced_security %}, which means you pay monthly for the number of licenses you use. You will not need to buy a predefined number of licenses in advance. See, "[AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises/about-usage-based-billing-for-licenses)."
70+
71+
If you did not set up a free trial and you want to use usage-based billing to pay for {% data variables.product.prodname_GH_advanced_security %} after the {% data variables.product.prodname_ghe_cloud %} trial ends, contact [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact).{% endif %}
72+
73+
* You can generate a {% data variables.product.prodname_ghe_server %} license file for the same quantity of users who are consuming a {% data variables.product.prodname_ghe_cloud %} license.
7874

7975
If you **cancel your trial**:
8076

@@ -100,6 +96,5 @@ You can end a trial by purchasing {% data variables.product.prodname_enterprise
10096

10197
## Further reading
10298

103-
* "[AUTOTITLE](/billing/managing-the-plan-for-your-github-account/about-per-user-pricing)"
10499
* "[AUTOTITLE](/admin/overview/best-practices-for-enterprises)"
105100
* [{% data variables.product.prodname_roadmap %}]({% data variables.product.prodname_roadmap_link %})

‎content/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security.md‎

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,18 @@ topics:
1919
shortTitle: Advanced Security billing
2020
---
2121

22+
{% ifversion metered-ghe-ghas %}
23+
24+
## Usage-based billing for {% data variables.product.prodname_GH_advanced_security %}
25+
26+
If you started a free trial of {% data variables.product.prodname_GH_advanced_security %} during your {% data variables.product.prodname_ghe_cloud %} trial on or after August 1, 2024, your billing for {% data variables.product.prodname_GH_advanced_security %} will be usage-based.
27+
28+
This means that you can use usage-based billing to pay for your licenses for both {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_GH_advanced_security %}. With usage-based billing, you pay for the number of licenses you use each month. You cannot access a trial of {% data variables.product.prodname_GH_advanced_security %} usage-based billing outside of a {% data variables.product.prodname_ghe_cloud %} trial.
29+
30+
If you have further questions about using {% data variables.product.prodname_GH_advanced_security %}, you can contact your account manager in {% data variables.contact.contact_enterprise_sales %}.
31+
32+
{% endif %}
33+
2234
## About licenses for {% data variables.product.prodname_GH_advanced_security %}
2335

2436
{% ifversion billing-auth-and-capture %}
@@ -73,19 +85,25 @@ You can make extra features for code security available to users by buying and u
7385

7486
## License size
7587

88+
{% ifversion metered-ghe-ghas %}
89+
90+
> [!IMPORTANT] If you have access to usage-based billing for {% data variables.product.prodname_GH_advanced_security %}, you will pay for the licenses you use each month and will not have a license limit. See "[AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises/about-usage-based-billing-for-licenses)."
91+
92+
{% endif %}
93+
7694
Each license for {% data variables.product.prodname_GH_advanced_security %} specifies a maximum number of accounts that can use these features. Each active committer to at least one repository with the feature enabled uses one {% ifversion ghas-billing-UI-update %}license{% else %}seat{% endif %}. A committer is considered active if one of their commits has been pushed to the repository within the last 90 days, regardless of when it was originally authored.
7795

7896
When you remove a user from your enterprise account, the user's license is freed within 24 hours.
7997

8098
{% ifversion ghes %}
81-
You can determine how many licenses you'll need for {% data variables.product.prodname_GH_advanced_security %} by generating a count of your instance's active committers in the site admin dashboard. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/site-admin-dashboard#advanced-security-committers)."
99+
You can determine how many licenses you'll need for {% data variables.product.prodname_GH_advanced_security %} by generating a count of your instance's active committers in the site admin dashboard. See "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/site-admin-dashboard#advanced-security-committers)."
82100
{% endif %}
83101

84102
If you are over your license limit, {% data variables.product.prodname_GH_advanced_security %} continues to work on all repositories where it is already enabled. However, in organizations where {% data variables.product.prodname_GH_advanced_security %} is enabled for new repositories, repositories will be created with the feature deactivated. In addition, the option to enable {% data variables.product.prodname_GH_advanced_security %} for existing repositories will not be available.
85103

86104
As soon as you free up some {% ifversion ghas-billing-UI-update %}licenses{% else %}seats{% endif %}, by deactivating {% data variables.product.prodname_GH_advanced_security %} for some repositories or by increasing your license size, the options for activating {% data variables.product.prodname_GH_advanced_security %} will work again as normal.
87105

88-
You can enforce policies to allow or disallow the use of {% data variables.product.prodname_advanced_security %} by organizations owned by your enterprise account. For more information, see "[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-advanced-security-in-your-enterprise)."
106+
You can enforce policies to allow or disallow the use of {% data variables.product.prodname_advanced_security %} by organizations owned by your enterprise account. See "[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-advanced-security-in-your-enterprise)."
89107

90108
For more information on viewing license usage, see "[AUTOTITLE](/billing/managing-billing-for-github-advanced-security/viewing-your-github-advanced-security-usage)."
91109

@@ -98,11 +116,7 @@ We record and display two numbers of {% ifversion ghas-billing-UI-update %}activ
98116

99117
If there are no unique {% ifversion ghas-billing-UI-update %}active {% endif %}committers, all active committers also contribute to other repositories or organizations that use {% data variables.product.prodname_GH_advanced_security %}. Deactivating the feature for that repository or organization would not free any {% ifversion ghas-billing-UI-update %}licenses{% else %}seats{% endif %} for {% data variables.product.prodname_GH_advanced_security %}.
100118

101-
{% note %}
102-
103-
**Note:** Users can contribute to multiple repositories or organizations. Usage is measured across the whole enterprise account to ensure that each member uses one {% ifversion ghas-billing-UI-update %}license {% else %}seat {% endif %}regardless of how many repositories or organizations the user contributes to.
104-
105-
{% endnote %}
119+
> [!NOTE] Users can contribute to multiple repositories or organizations. Usage is measured across the whole enterprise account to ensure that each member uses one {% ifversion ghas-billing-UI-update %}license {% else %}seat {% endif %}regardless of how many repositories or organizations the user contributes to.
106120
107121
When you activate or deactivate {% data variables.product.prodname_advanced_security %} for repositories, {% data variables.product.prodname_dotcom %} displays an overview of changes to the use of your license. If you deactivate access to {% data variables.product.prodname_GH_advanced_security %}, any {% ifversion ghas-billing-UI-update %}licenses{% else %}seats{% endif %} used by unique active committers are freed up.
108122

@@ -122,11 +136,7 @@ The following example timeline demonstrates how active committer count for {% da
122136
| <span style="white-space: nowrap;">August 15</span> | A member of your enterprise enables {% data variables.product.prodname_GH_advanced_security %} for a second repository, repository **Y**. In the last 90 days, a total of 20 developers contributed to that repository. Of those 20 developers, 10 also recently worked on repo **X** and do not require additional licenses. | 49 + 10 =<br>**59** |
123137
| <span style="white-space: nowrap;">August 16</span> | A member of your enterprise disables {% data variables.product.prodname_GH_advanced_security %} for repository **X**. Of the 49 developers who were working on repository **X**, 10 still also work on repository **Y**, which has a total of 20 developers contributing in the last 90 days. | 49 - 29 =<br>**20** |
124138

125-
{% note %}
126-
127-
**Note:** A user will be flagged as active when their commits are pushed to any branch of a repository, even if the commits were authored more than 90 days ago.
128-
129-
{% endnote %}
139+
> [!NOTE] A user will be flagged as active when their commits are pushed to any branch of a repository, even if the commits were authored more than 90 days ago.
130140
131141
## Getting the most out of {% data variables.product.prodname_GH_advanced_security %}
132142

@@ -138,7 +148,7 @@ When you decide which repositories and organizations to prioritize for {% data v
138148
When you have enabled {% data variables.product.prodname_GH_advanced_security %} for these organizations or repositories, assess which other codebases you could add without incurring billing for unique {% ifversion ghas-billing-UI-update %}active {% endif %}committers. Finally, review the remaining important and busy codebases. If you want to increase the number of {% ifversion ghas-billing-UI-update %}licensed active committers, {% else %}seats in your license, {% endif %}contact {% data variables.contact.contact_enterprise_sales %}.
139149

140150
{% ifversion ghas-in-license-sync %}
141-
If your enterprise uses {% data variables.product.prodname_GH_advanced_security %} on both {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}, you can ensure users aren't consuming multiple licenses unnecessarily by synchronizing license usage between environments.{% ifversion ghec %} {% data variables.product.prodname_GH_advanced_security %} is included in license sync in {% data variables.product.prodname_ghe_server %} version 3.12 and later.{% endif %} For more information, see "[AUTOTITLE](/billing/managing-your-license-for-github-enterprise/syncing-license-usage-between-github-enterprise-server-and-github-enterprise-cloud)."
151+
If your enterprise uses {% data variables.product.prodname_GH_advanced_security %} on both {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}, you can ensure users aren't consuming multiple licenses unnecessarily by synchronizing license usage between environments.{% ifversion ghec %} {% data variables.product.prodname_GH_advanced_security %} is included in license sync in {% data variables.product.prodname_ghe_server %} version 3.12 and later.{% endif %} See "[AUTOTITLE](/billing/managing-your-license-for-github-enterprise/syncing-license-usage-between-github-enterprise-server-and-github-enterprise-cloud)."
142152
{% endif %}
143153

144154
{% endif %}

‎content/billing/managing-billing-for-github-advanced-security/managing-your-github-advanced-security-licensing.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ topics:
1111
- Enterprise
1212
shortTitle: Manage Advanced Security licensing
1313
---
14-
## About licensing for GitHub Advanced Security
14+
## About licensing for {% data variables.product.prodname_GH_advanced_security %}
1515

1616
Each license for {% data variables.product.prodname_GH_advanced_security %} specifies a maximum number of accounts that can use these features. Each active committer to at least one repository with the feature enabled uses one {% ifversion ghas-billing-UI-update %}license{% else %}seat{% endif %}. A committer is considered active if one of their commits has been pushed to the repository within the last 90 days, regardless of when it was originally authored. For more information about committer numbers, see "[AUTOTITLE](/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security)." For information about purchasing a license, see "[AUTOTITLE](/billing/managing-billing-for-github-advanced-security/signing-up-for-github-advanced-security)."
1717

@@ -27,7 +27,7 @@ Each license for {% data variables.product.prodname_GH_advanced_security %} spec
2727
{% data reusables.enterprise-accounts.access-enterprise %}
2828
{% data reusables.enterprise-accounts.settings-tab %}
2929
{% data reusables.enterprise-accounts.license-tab %}
30-
1. Under "{% data variables.product.prodname_GH_advanced_security %} GitHub Advanced Security", click **Committers**.
30+
1. Under "{% data variables.product.prodname_GH_advanced_security %}", click **Committers**.
3131

3232
![Screenshot of the {% data variables.product.prodname_GH_advanced_security %} licensing screen. The "Committers" dropdown is highlighted with an orange line.](/assets/images/help/enterprises/ghas-committers-dropdown.png)
3333
1. Under "Committers", click **Manage committers**.
@@ -41,7 +41,7 @@ Each license for {% data variables.product.prodname_GH_advanced_security %} spec
4141
{% data reusables.enterprise-accounts.access-enterprise %}
4242
{% data reusables.enterprise-accounts.settings-tab %}
4343
{% data reusables.enterprise-accounts.license-tab %}
44-
1. To the right of "GitHub Advanced Security", click **Manage**, then click **Cancel Subscription**.
44+
1. To the right of "{% data variables.product.prodname_GH_advanced_security %}", click **Manage**, then click **Cancel Subscription**.
4545

4646
![Screenshot of the "Manage" dropdown in the {% data variables.product.prodname_GH_advanced_security %} licensing screen. The "Cancel Subscription" button is highlighted with an orange outline.](/assets/images/help/enterprises/ghas-cancel-subscription.png)
4747
1. To confirm your cancellation, click **I understand, cancel Advanced Security**.

0 commit comments

Comments
 (0)