diff options
Diffstat (limited to 'doc/subscriptions/gitlab_com/index.md')
| -rw-r--r-- | doc/subscriptions/gitlab_com/index.md | 173 |
1 files changed, 44 insertions, 129 deletions
diff --git a/doc/subscriptions/gitlab_com/index.md b/doc/subscriptions/gitlab_com/index.md index e174a144cfc..b72fad02b3d 100644 --- a/doc/subscriptions/gitlab_com/index.md +++ b/doc/subscriptions/gitlab_com/index.md @@ -11,25 +11,32 @@ GitLab SaaS is the GitLab software-as-a-service offering, which is available at You don't need to install anything to use GitLab SaaS, you only need to [sign up](https://gitlab.com/users/sign_up). When you sign up, you choose: -- [A license tier](https://about.gitlab.com/pricing/). +- [A subscription](https://about.gitlab.com/pricing/). - [The number of seats you want](#how-seat-usage-is-determined). -All GitLab SaaS public projects, regardless of the subscription, get access to features in the **Ultimate** tier. -Qualifying open source projects also get 50,000 CI minutes and free access to the **Ultimate** tier +The subscription determines which features are available for your private projects. Public projects automatically get **Ultimate** tier features. + +Qualifying open source projects also get 50,000 CI/CD minutes and free access to the **Ultimate** tier through the [GitLab for Open Source program](https://about.gitlab.com/solutions/open-source/). ## Obtain a GitLab SaaS subscription +A GitLab SaaS subscription applies to a top-level group. +Members of every subgroup and project in the group: + +- Can use the features of the subscription. +- Consume seats in the subscription. + To subscribe to GitLab SaaS: 1. View the [GitLab SaaS feature comparison](https://about.gitlab.com/pricing/gitlab-com/feature-comparison/) and decide which tier you want. 1. Create a user account for yourself by using the [sign up page](https://gitlab.com/users/sign_up). -1. Create a [group](../../user/group/index.md#create-a-group). You use the group to grant users access to several projects - at once. A group is not required if you plan to have projects in a personal namespace instead. +1. Create a [group](../../user/group/index.md#create-a-group). Your license tier applies to the top-level group, its subgroups, and projects. 1. Create additional users and - [add them to the group](../../user/group/index.md#add-users-to-a-group). + [add them to the group](../../user/group/index.md#add-users-to-a-group). The users in this group, its subgroups, and projects can use + the features of your license tier, and they consume a seat in your subscription. 1. On the left sidebar, select **Billing** and choose a tier. 1. Fill out the form to complete your purchase. @@ -62,10 +69,12 @@ The following information is displayed: email address. A GitLab SaaS subscription uses a concurrent (_seat_) model. You pay for a -subscription according to the maximum number of users enabled at one time. You can +subscription according to the maximum number of users assigned to the top-level group or its children during the billing period. You can add and remove users during the subscription period, as long as the total users at any given time doesn't exceed the subscription count. +A top-level group can be [changed](../../user/group/index.md#change-a-groups-path) like any other group. + Every user is included in seat usage, with the following exceptions: - Users who are pending approval. @@ -77,6 +86,12 @@ Every user is included in seat usage, with the following exceptions: Seat usage is reviewed [quarterly or annually](../quarterly_reconciliation.md). +If a user navigates to a different top-level group (one they have created themselves, for example) +and that group does not have a paid subscription, they would not see any of the paid features. + +It is also possible for users to belong to two different top-level groups with different subscriptions. +In this case, they would see only the features available to that subscription. + ### View seat usage To view a list of seats being used: @@ -124,7 +139,7 @@ and is not affected by the current search. A GitLab subscription is valid for a specific number of users. If the number of billable users exceeds the number included in the subscription, known -as the number of **seats owed**, you must pay for the excess number of users before renewal. +as the number of **seats owed**, you must pay for the excess number of users. For example, if you purchase a subscription for 10 users: @@ -138,9 +153,9 @@ Seats owed = 12 - 10 (Maximum users - users in subscription) ### Add users to your subscription -You can add users to your subscription at any time during the subscription period. The cost of -additional users added during the subscription period is prorated from the date of purchase through -the end of the subscription period. +Your subscription cost is based on the maximum number of seats you use during the billing period. +Even if you reach the number of seats in your subscription, you can continue to add users. +GitLab [bills you for the overage](../quarterly_reconciliation.md). To add users to a subscription: @@ -219,6 +234,8 @@ of the date of expiry with a banner in the GitLab user interface. To renew your subscription: 1. Log in to the [Customers Portal](https://customers.gitlab.com/customers/sign_in) and beneath your existing subscription, select **Renew**. +The **Renew** button remains disabled (grayed-out) until 15 days before a subscription expires. +You can hover your mouse on the **Renew** button to see the date when it will become active. 1. Review your renewal details and complete the payment process. 1. Select **Confirm purchase**. @@ -250,132 +267,30 @@ previous period), log in to the [Customers Portal](https://customers.gitlab.com/ If you have difficulty during the renewal process, contact the [Support team](https://support.gitlab.com/hc/en-us/requests/new?ticket_form_id=360000071293) for assistance. -## Change the contact person for your subscription - -To change the contact person who manages your subscription, -contact the GitLab [Support team](https://support.gitlab.com/hc/en-us/requests/new?ticket_form_id=360000071293). - -## CI pipeline minutes - -CI pipeline minutes are the execution time for your [pipelines](../../ci/pipelines/index.md) -on GitLab shared runners. Each [GitLab SaaS tier](https://about.gitlab.com/pricing/) -includes a monthly quota of CI pipeline minutes for private and public projects in -the namespace: - -| Plan | CI pipeline minutes | -|----------|---------------------| -| Free | 400 | -| Premium | 10,000 | -| Ultimate | 50,000 | - -The consumption rate for CI pipeline minutes is based on the visibility of the projects: - -- Private projects in the namespace consume pipeline minutes at a rate of 1 CI pipeline minute - per 1 minute of execution time on GitLab shared runners. -- Public projects in: - - Namespaces [created on or after 2021-07-17](https://gitlab.com/gitlab-org/gitlab/-/issues/332708) - consume pipeline minutes at a slower rate, 1 CI pipeline minute per 125 minutes - of execution time on GitLab shared runners. The per-minute rate for public projects - is 0.008 CI pipeline minutes per 1 minute of execution time on GitLab shared runners. - - Namespaces created before 2021-07-17 do not consume CI pipeline minutes. - -| Plan | CI pipeline minutes | Maximum **private** project execution time (all namespaces) | Maximum **public** project execution time (namespaces created 2021-07-17 and later) | -|----------|---------------------|-------------------------------------------------------------|-------------------------------------------------------------------------------------| -| Free | 400 | 400 minutes | 50,000 minutes | -| Premium | 10,000 | 10,000 minutes | 1,250,000 minutes | -| Ultimate | 50,000 | 50,000 minutes | 6,250,000 minutes | - -Quotas apply to: - -- Groups, where the minutes are shared across all members of the group, its - subgroups, and nested projects. To view the group's usage, navigate to the group, - then **Settings > Usage Quotas**. -- Your personal account, where the minutes are available for your personal projects. - To view and buy personal minutes: - - 1. In the top-right corner, select your avatar. - 1. Select **Edit profile**. - 1. On the left sidebar, select **[Usage Quotas](https://gitlab.com/-/profile/usage_quotas#pipelines-quota-tab)**. - -Only pipeline minutes for GitLab shared runners are restricted. If you have a -specific runner set up for your projects, there is no limit to your build time on GitLab SaaS. - -The available quota is reset on the first of each calendar month at midnight UTC. +## Add or change the contacts for your subscription -When the CI minutes are depleted, an email is sent automatically to notify the owner(s) -of the namespace. You can [purchase additional CI minutes](#purchase-additional-ci-minutes), -or upgrade your account to a higher [plan](https://about.gitlab.com/pricing/). -Your own runners can still be used even if you reach your limits. +Contacts can renew a subscription, cancel a subscription, or transfer the subscription to a different namespace. -### Purchase additional CI minutes +To change the contacts: -If you're using GitLab SaaS, you can purchase additional CI minutes so your -pipelines aren't blocked after you have used all your CI minutes from your -main quota. You can find pricing for additional CI/CD minutes on the -[GitLab Pricing page](https://about.gitlab.com/pricing/). Additional minutes: +1. Ensure an account exists in the + [Customers Portal](https://customers.gitlab.com/customers/sign_in) for the user you want to add. +1. Verify you have access to at least one of + [these requirements](https://about.gitlab.com/handbook/support/license-and-renewals/workflows/customersdot/associating_purchases.html). +1. [Create a ticket with the Support team](https://support.gitlab.com/hc/en-us/requests/new?ticket_form_id=360000071293). Include any relevant material in your request. -- Are only used after the shared quota included in your subscription runs out. -- Roll over month to month. - -To purchase additional minutes for your personal namespace: - -1. In the top-right corner, select your avatar. -1. Select **Edit profile**. -1. On the left sidebar, select **Usage Quotas**. -1. Select **Buy additional minutes** and GitLab redirects you to the Customers Portal. -1. Locate the subscription card that's linked to your personal namespace on GitLab SaaS, click **Buy more CI minutes**, and complete the details about the transaction. - -After we process your payment, the extra CI minutes are synced to your group -namespace. - -To confirm the available CI minutes for your personal projects, go to the **Usage Quotas** settings again. - -The **Additional minutes** displayed now includes the purchased additional CI -minutes, plus any minutes rolled over from last month. - -Be aware that: - -- Extra CI minutes assigned to one group cannot be transferred to a different - group. -- If you have used more minutes than your default quota, those minutes are - deducted from your Additional Minutes quota immediately after your purchase of - additional minutes. - -### Purchase additional CI minutes on GitLab SaaS - -> [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/6574) in GitLab 14.5. - -If you're using GitLab SaaS, you can purchase additional CI minutes so your -pipelines aren't blocked after you have used all your CI minutes from your -main quota. You can find pricing for additional CI/CD minutes on the -[GitLab Pricing page](https://about.gitlab.com/pricing/). Additional minutes: - -- Are only used after the shared quota included in your subscription runs out. -- Roll over month to month. - -To purchase additional minutes for your group on GitLab SaaS: - -1. On the top bar, select **Menu > Groups** and find your group. -1. On the left sidebar, select **Settings > Usage Quotas**. -1. Select **Buy additional minutes**. -1. Complete the details about the transaction. - -After we process your payment, the extra CI minutes are synced to your group -namespace. +## CI/CD minutes -To confirm the available CI minutes, go to your group, and then select -**Settings > Usage Quotas**. +CI/CD minutes are the execution time for your [pipelines](../../ci/pipelines/index.md) +on GitLab shared runners. -The **Additional minutes** displayed now includes the purchased additional CI -minutes, plus any minutes rolled over from last month. +Refer to [CI/CD minutes](../../ci/pipelines/cicd_minutes.md) +for more information. -Be aware that: +### Purchase additional CI/CD minutes -- Extra CI minutes assigned to one group cannot be transferred to a different - group. -- If you have used more minutes than your default quota, those minutes are - deducted from your Additional Minutes quota immediately after your purchase of - additional minutes. +You can [purchase additional minutes](../../ci/pipelines/cicd_minutes.md#purchase-additional-cicd-minutes) +for your personal or group namespace. ## Storage subscription |