Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add note about resource quota #645

Merged
merged 1 commit into from
Oct 10, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions docs/rancher/resource-quota.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,21 +20,26 @@ description: ResourceQuota allows administrators to set resource limits per name
In Harvester, ResourceQuota can define usage limits for the following resources:
- **CPU:** Limits compute resource usage, including CPU cores and CPU time.
- **Memory:** Limits the usage of memory resources in bytes or other recognizable memory units.
- **Storage:** Limits the usage of storage resources.

## Set ResourceQuota via Rancher
In the Rancher UI, administrators can configure resource quotas for namespaces through the following steps:

1. Click the hamburger menu and choose the **Virtualization Management** tab.
1. Choose one of the clusters and go to **Projects/Namespaces** > **Create Project**.
1. Specify the desired project **Name**. Next, go to the **Resource Quotas** tab and select the **Add Resource** option. Within the **Resource Type** field, select either **CPU Limit** or **Memory Limit** and define the **Project Limit** and **Namespace Default Limit** values.
![](/img/v1.2/rancher/create-project.png)
![](/img/v1.4/rancher/create-project.png)

You can configure the **Namespace** limits as follows:

1. Find the newly created project, and select **Create Namespace**.
1. Specify the desired namespace **Name**, and adjust the limits.
1. Complete the process by selecting **Create**.
![](/img/v1.2/rancher/create-namespace.png)
![](/img/v1.4/rancher/create-namespace.png)

:::note
Attempts to provision VMs for guest clusters are blocked when the resource quotas are reached. Rancher responds by creating a new VM in a loop, in which each failed attempt to create a VM is immediately followed by another creation attempt. This results in a transient error state in the cluster that is not recorded as the VM is recreated.
:::

## Overhead memory of virtual machine
Upon creating a virtual machine (VM), the VM controller seamlessly incorporates overhead resources into the VM's configuration. These additional resources intend to guarantee the consistent and uninterrupted functioning of the VM. It's important to note that configuring memory limits requires a higher memory reservation due to the inclusion of these overhead resources.
Expand Down
Binary file added static/img/v1.4/rancher/create-namespace.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/v1.4/rancher/create-project.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.