Project Resource Quotas

In situations where several teams share a cluster, one team may overconsume the resources available: CPU, memory, storage, services, Kubernetes objects like pods or secrets, and so on. To prevent this overconsumption, you can apply a resource quota, which is a Rancher feature that limits the resources available to a project or namespace.

This page is a how-to guide for creating resource quotas in existing projects.

Resource quotas can also be set when a new project is created. For details, refer to the section on creating new projects.

Resource quotas in Rancher include the same functionality as the native version of Kubernetes. In Rancher, resource quotas have been extended so that you can apply them to projects. For details on how resource quotas work with projects in Rancher, refer to this page.

Applying Resource Quotas to Existing Projects

Edit resource quotas when:

  • You want to limit the resources that a project and its namespaces can use.

  • You want to scale the resources available to a project up or down when a resource quota is already in effect.

    1. In the upper left corner, click ☰ > Cluster Management.

    2. On the Clusters page, go to the cluster where you want to apply a resource quota and click Explore.

    3. Click Cluster  Projects/Namespaces.

    4. Make sure that the Projects/Namespaces page is in Group by Project view mode. image::edit-project-config-for-resource-quotas-group-by-project.png[Screenshot highlighting the "Group by Project" icon, above the list of projects. It resembles a folder.]

    5. Find the project that you want to add a resource quota to, and select the ⋮ that’s on the same row as the project’s name. image::edit-project-config-for-resource-quotas-dots.png[Screenshot highlighting triple dots icon at the end of the same row as the project name.]

    6. Select Edit Config.

    7. Expand Resource Quotas and click Add Resource. Alternatively, you can edit existing quotas.

    8. Select a Resource Type. For more information on types, see the quota type reference.

    9. Enter values for the Project Limit and the Namespace Default Limit.

      Field Description

      Project Limit

      The overall resource limit for the project.

      Namespace Default Limit

      The default resource limit available for each namespace. This limit is propagated to each namespace in the project. The combined limit of all project namespaces shouldn’t exceed the project limit.

    10. Optional: Add more quotas.

    11. Click Create.

Result: The resource quota is applied to your project and namespaces. When you add more namespaces in the future, Rancher validates that the project can accommodate the namespace. If the project can’t allocate the resources, you may still create namespaces, but they will be given a resource quota of 0. Subsequently, Rancher will not allow you to create any resources restricted by this quota.