Synnefo

Projects and quota

~~~~~~~~~~~~~~~~~~

Synnefo supports granting resources and controling their quota through the

mechanism of *projects*. A project is considered as a pool of finite

resources. Every actual resources allocated by a user (e.g. a Cyclades VM or

a Pithos container) is also assigned to a project where the user is a

member to. For each resource a project specifies the maximum amount that can

be assigned to it and the maximum amount that a single member can assign to it.

Default quota

`````````````

Upon user creation, a special purpose user-specific project is automatically

created in order to hold the base quota provided by the system. These *base*

projects are identified with the same UUID as the user.

To inspect the quota that future users will receive by default through their

base projects, check column ``base_default`` in::

   # snf-manage resource-list

You can modify the default base quota limit for all future users with::

   # snf-manage resource-modify <resource_name> --base-default <value>

Grant extra quota through projects

``````````````````````````````````

A user can apply for a new project through the web interface or the API.

Once it is approved by the administrators, the applicant can join the

project and let other users in too.

A project member can make use of the quota granted by the project by

specifying this particular project when creating a new quotable entity.

Note that quota are not accumulative: in order to allocate a 100GB disk,

one must be in a project that grants at least 100GB; it is not possible to

add up quota from different projects. Note also that if allocating an entity

requires multiple resources (e.g. cpu and ram for a Cyclades VM) these must

be all assigned to a single project.

Control projects

````````````````

Before taking an action, on can inspect project status, settings and quota

limits with::

   # snf-manage project-show <project-uuid>

For an initialized project, option ``--quota`` also reports the resource

usage.

Users designated as *project admins* can approve or deny

Set quota limits

````````````````

One can change the quota limits of an initialized project with::

   # snf-manage project-modify <project-uuid> --limit <resource_name> <member_limit> <project_limit>

One can set base quota for all accepted users (that is, set limits for base

project), with possible exceptions, with::

   # snf-manage project-modify --all-base-projects --exclude <uuid1>,<uuid2> --limit ...

Quota for a given resource are reported for all projects that the user is

member in with::

   # snf-manage user-show <user-uuid> --quota

With option ``--projects``, owned projects and memberships are also reported.