Skip to content

Commit e44e5be

Browse files
authored
Merge pull request #2069 from CSCfi/rahti2-quotas
Rewrite Rahti 2 quota
2 parents d425ca4 + 0564eb6 commit e44e5be

File tree

1 file changed

+21
-62
lines changed

1 file changed

+21
-62
lines changed

docs/cloud/rahti2/usage/projects_and_quota.md

Lines changed: 21 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -119,9 +119,13 @@ For more information about using the web interface, refer to the
119119
[official OpenShift documentation](https://docs.okd.io/) (our current version is 4.15). You can find out which version of the documentation to look at in the web interface by
120120
clicking the question mark symbol in the top bar and selecting "About".
121121

122-
## Project quotas
122+
## CSC computing project quotas
123123

124-
Each project has its own quota. Initial quota is the following:
124+
!!! warning
125+
126+
Starting June 5th, 2024 a new quota system will be applied. Namespaces/Rahti projects quota will be removed to only have CSC projects quota.
127+
128+
Each CSC computing project has its own quota. Initial quota is the following:
125129

126130
| Resource | Default |
127131
|----------------------------------|---------|
@@ -131,7 +135,12 @@ Each project has its own quota. Initial quota is the following:
131135
| Number of image streams (images) | 20 |
132136
| Size of each registry images | 5 GiB |
133137

134-
This means that your project can use up to 4 cores and 16GiB in total, it can be 1 Pod using the whole 4 cores and 16 GiB, 8 pods each using half a core and 2 GiB, etc...
138+
This means that your CSC computing project can use up to 4 cores and 16GiB in total, it can be 1 Pod using the whole 4 cores and 16 GiB, 8 pods each using half a core and 2 GiB, etc...
139+
140+
!!! Warning
141+
142+
If you have several users that can access the CSC computing project, they can create a new Rahti project (see above). Keep in mind that the quotas will be shared across the different Rahti projects.
143+
If you need to adjust your CSC computing project quotas, please contact us. More information [here](projects_and_quota.md#requesting-more-quota)
135144

136145
You can find the resource usage and quota of a project in the project view in
137146
the web interface under **Administration -> ResourceQuota** and **Administration -> LimitRanges** in the `Administrator` menu.
@@ -174,69 +183,25 @@ The user can set the limits explicitly within the available quota, but if no lim
174183

175184
|Type|CPU|Memory|
176185
|:-:|:-:|:-:|
177-
|limits|500m|1Gi|
186+
|limits|250m|2500Mi|
178187
|requests|50m|500Mi|
179188

180189
Note: `m` stands for milicores. `500m` will be the equivalent of 0.5 cores, or in other words half of the time of a CPU core.
181190

182-
Rahti 2 enforces a maximum limit/request ratio of 5. This means that the CPU or memory `limits` cannot be more than 5 times the `request`. So if the CPU request is 100m, the CPU limit cannot be set higher than 500m. And if the CPU limit of 1 is desired, the request must be set to 200m at least. Following example shows how a pod `resources` configuration may look like.
183-
184-
```yaml
185-
resources:
186-
requests:
187-
cpu: "200m"
188-
limits:
189-
cpu: "1"
190-
```
191-
192-
## Cluster Quotas
193-
194-
In addition to the project resource quota, cluster resource quota is in use. This quota is shared by multiple projects created by the same user. This means that cluster quota is enforced per user. A single user will be able to request as many projects as it is necessary, but the total resource use of all these projects cannot exceed the cluster quota.
195-
196-
Initial cluster quotas are 5 times of the project resource quota.
197-
198-
| Resource type | Quota |
199-
| --- | --- |
200-
| limits.cpu | 20 |
201-
| limits.memory | 80Gi |
202-
| request.storage | 500Gi |
203-
| limits.ephemeral-storage | 25Gi |
204-
| openshift.io/imagestreams | 100 |
205-
| persistentvolumeclaims | 25 |
206-
| pods | 500 |
207-
208-
You can check your current cluster quota by running this command line:
209-
210-
```sh
211-
$ oc describe AppliedClusterResourceQuota
212-
213-
Name: crq-XXXXXXXX
214-
Created: 19 hours ago
215-
Labels: <none>
216-
Annotations: <none>
217-
Namespace Selector: ["test"]
218-
Label Selector:
219-
AnnotationSelector: map[openshift.io/requester:XXXXXXXX]
220-
Resource Used Hard
221-
-------- ---- ----
222-
limits.cpu 0 20
223-
limits.ephemeral-storage 0 25Gi
224-
limits.memory 0 80Gi
225-
openshift.io/imagestreams 1 100
226-
persistentvolumeclaims 0 25
227-
pods 0 500
228-
requests.storage 0 500Gi
229-
```
230-
231-
It not only shows the Quota, but also the current Usage.
191+
Rahti 2 enforces a maximum limit/request ratio of 5. This means that the CPU or memory `limits` cannot be more than 5 times the `request`. So if the CPU request is 50m, the CPU limit cannot be higher than 250m. And if you want to increase the CPU limit to 1, you will have to increase as well the request to at least 200m.
232192

233193
## Requesting more quota
234194

235-
If you need more resources that the defaults, you can apply for more quota by contacting the Service Desk. See the [Contact page](../../../support/contact.md) for instructions. Quota requests are
236-
handled on a case-by-case basis depending on the currently available resourcesin Rahti 2 and the use case.
195+
If you need more resources than the defaults, you can apply for more quota by contacting the Service Desk. See the [Contact page](../../../support/contact.md) for instructions. Quota requests are handled on a case-by-case basis depending on the currently available resources in Rahti 2 and the use case.
237196

238197
## Sharing projects with other users
239198

199+
!!! info
200+
201+
When creating a Rahti 2 project which is associated with certain CSC computing project, by default all members the of
202+
CSC computing project will have admin access to the Rahti 2 project.
203+
You can also add individually an user to a specific Rahti 2 project. The user must have a CSC or HAKA login.
204+
240205
OpenShift has a flexible role-based access control system that allows you to
241206
give access to projects you have created to other users and groups in the system.
242207
You can give e.g. full admin, basic user, edit or read only access to other
@@ -252,12 +217,6 @@ with others. Rahti 2 allows you to freely enter any username and will not notify
252217
you for having entered a non-existent username. Usernames are also case-sensitive.
253218
You can find out your username in Rahti 2 via the command line, by using the command `oc whoami`.
254219

255-
!!! info
256-
257-
When creating a Rahti 2 project which is associated with certain CSC computing project, by default all members the of
258-
CSC computing project will have admin access to the Rahti 2 project. This also means that you can add administrators to
259-
your Rahti 2 project by adding them directly to your CSC project.
260-
261220
## Deleting a project
262221

263222
In order to delete a project, you need to go to the main landing page and click in the 3 vertical dots next to the name of the project. In the drop down menu, you will see the option "Delete Project"

0 commit comments

Comments
 (0)