Project Quotas
KubeSphere uses Kubernetes requests and limits to control resource (for example, CPU and memory) usage in a project, also known as ResourceQuotas in Kubernetes. Requests make sure a project can get the resources it needs as they are specifically guaranteed and reserved. On the contrary, limits ensure that a project can never use resources above a certain value.
Besides CPU and memory, you can also set resource quotas for other objects separately such as Pods, Deployments, Jobs, Services and ConfigMaps in a project.
This tutorial demonstrates how to configure quotas for a project.
Prerequisites
You have an available workspace, a project and an account (ws-admin
). The account must have the admin
role at the workspace level. For more information, see Create Workspaces, Projects, Accounts and Roles.
Note
project-admin
(an account of the admin
role at the project level), you can set project quotas as well for a new project (i.e. its quotas remain unset). However, project-admin
cannot change project quotas once they are set. Generally, it is the responsibility of ws-admin
to set limits and requests for a project. project-admin
is responsible for setting limit ranges for containers in a project.Set Project Quotas
-
Log in to the console as
ws-admin
and go to a project. On the Overview page, you can see project quotas remain unset if the project is newly created. Click Set to configure quotas. -
In the dialog that appears, you can see that KubeSphere does not set any requests or limits for a project by default. To set limits to control CPU and memory resources, use the slider to move to a desired value or enter numbers directly. Leaving a field blank means you do not set any requests or limits.
Note
The limit can never be lower than the request. -
To set quotas for other resources, click Add Quota Item and select an object from the list.
-
Click OK to finish setting quotas.
-
Go to Basic Information in Project Settings, and you can see all resource quotas for the project.
-
To change project quotas, click Manage Project on the Basic Information page and select Edit Quota.
Note
For a multi-cluster project, the option Edit Quota does not display in the Manage Project drop-down menu. To set quotas for a multi-cluster project, go to Quota Management under Project Settings and click Edit Quota. Note that as a multi-cluster project runs across clusters, you can set resource quotas on different clusters separately. -
Change project quotas in the dialog that appears and click OK.
See Also
Feedback
Was this page Helpful?
Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.