Skip to main content
Version: master

Create

Create A Project​

To get started creating a Project, in the Loft UI:

  1. Navigate to the Projects view.
  2. Next to the Project drop down, click the + button to open the create project drawer.
  3. Click on Members and add your desired users or teams and their assigned project roles. See the Members section for more details.
  4. Next, click on Allowed Templates to set the templates allowed for the project's space and virtual cluster instances. See Templates for more details.
  5. Next, click on Allowed Clusters to set the clusters that members should have access to. See the Clusters section for further details.
  6. Optionally, if you're an Argo CD user and want to enabled the Argo CD Integration, visit the Argo CD section to configure. See the Argo CD documentation for further details.
  7. Once all project options have been specified, click the .

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.

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.