Quotas

Project Quotas allow you to set space instance and virtual cluster instance limits for each project. Quotas can be defined across the whole project or on a per-user basis. Optionally, you may use qualifiers to apply the following limits on space instances and virtual cluster instances.

Project quotas with multiple virtual cluster

Please be aware that when you create multiple virtual cluster instances, the individually used resources count toward the shared project quota.

Active Quotas

An instance limit followed by .active will restrict the number of instances that can be active at the same time. These are enforced during instance creation, but also when a request is received to wake up a sleeping instance. This qualifier can be applied to either space instances or virtual cluster instances:

Template Quotas

An instance limit containing .template=template-name will restrict the number of instances that are using the given template at the same time. These are enforced during instance creation. This qualifier can be applied to either space instances or virtual cluster instances.

Project Quotas

To configure project quotas follow these steps:

1. Navigate to the Projects tab and select the project to configure from the drop down.
2. Click on Project Settings.
3. Click on Quotas.
4. Select the Per Project tab.
5. Click on the . An entry in the quota table will appear.
6. For the Resource column, select the desired resource. If limiting space instances or virtual cluster instances, you may optionally select spaceinstance.active or virtualclusterinstance.active respectively.
7. Optionally for the Template column, select the template on which you'd like to set a limit.
8. For the Quota column, enter a number or use the step selector to increase or decrease to the desired count.
9. Once all project options have been specified, click the .

User and Team Quotas

Quotas that apply for each user or team can be defined as well. These quotas apply to all users or teams and cannot be applied to specific users and teams. For example, this project defines a total space instance quota of 20, but prevents any user or team from using more than 5 spaces. By adjusting these quotas, you can ensure that no user or team uses more than their fair share of cluster resources.

To configure quotas using the UI, follow these steps:

1. Navigate to the Projects tab and select the project to configure from the drop down.
2. Click on Project Settings.
3. Click on Quotas.
4. Select the Per User / Team tab.
5. Click on the . An entry in the quota table will appear.
6. For the Resource column, select the desired resource. If limiting space instances or virtual cluster instances, you may optionally select spaceinstance.active or virtualclusterinstance.active respectively.
7. Optionally for the Template column, select the template on which you'd like to set a limit.
8. For the Quota column, enter a number or use the step selector to increase or decrease to the desired count.
9. Once all project options have been specified, click the .

Team and Team Member Quotas

If a team is the owner of a space or virtual cluster the usage will be counted by the team and not count against each member of the team, nor will the usage of a team member count towards the team's quota.

Exceeding Quotas

Once the project quotas are defined, users and teams are free to create space instances and virtual cluster instances up to the defined limits. However, once the usage meets the limit, attempts to create a new virtual cluster instance or space instance will be rejected with an error message indicating the resource type and limit that would be exceeded. Here are examples of possible error messages:

• Error: metadata.name: Forbidden: cannot create spaceinstance, because project spaceinstances limit of 5 would be exceeded
• Error: metadata.name: Forbidden: cannot create spaceinstance, because per-user spaceinstances limit of 5 would be exceeded
• Error: metadata.name: Forbidden: cannot create virtualclusterinstance, because project virtualclusterinstances limit of 5 would be exceeded
• Error: metadata.name: Forbidden: cannot create virtualclusterinstance, because per-user virtualclusterinstances limit of 5 would be exceeded

Changing Quotas

In order to avoid these errors in practice, quotas may be increased. Decreasing quotas, on the other hand, will not result in spaces being automatically deleted. In these cases, it is possible and expected that the number of spaces or virtual clusters will exceed limits.