feature: tagged resource limits (#379)

* feature: tagged resource limits

apache/cloudstack#8362

Signed-off-by: Abhishek Kumar <abhishek.mrt22@gmail.com>

* missing

Signed-off-by: Abhishek Kumar <abhishek.mrt22@gmail.com>

* update template tag details

Signed-off-by: Abhishek Kumar <abhishek.mrt22@gmail.com>

* instance deploy

Signed-off-by: Abhishek Kumar <abhishek.mrt22@gmail.com>

* Update source/adminguide/usage.rst

Co-authored-by: Suresh Kumar Anaparti <sureshkumar.anaparti@gmail.com>

* Update source/adminguide/usage.rst

Co-authored-by: Vishesh <vishesh92@gmail.com>

---------

Signed-off-by: Abhishek Kumar <abhishek.mrt22@gmail.com>
Co-authored-by: Suresh Kumar Anaparti <sureshkumar.anaparti@gmail.com>
Co-authored-by: Vishesh <vishesh92@gmail.com>

Author: 3 people

source/_static/images/account-limits.png

@@ -268,6 +268,9 @@ To upload a Template:
             selecting an OS Type when registering a Template if the option 'Read Instance settings from OVA' is selected. In this case, the OS Type is
             obtained from the Template after it is registered.
 
+   -  **Tag**: The tag for the template. This tag can be used with host tags to
+      allow deployment of Instances on specific hosts.
+
    -  **Userdata**: The registered Userdata are listed. Select the
       desired one.
 

source/_static/images/template-upload-from-local.png

@@ -263,6 +263,23 @@ max.project.secondary.storage (GB)  Maximum secondary storage space that can be
                                     Default is 400.
 =================================== =================================================================
 
+The administrator can also set limits for specific tagged host and storage
+resources for an account or domain. Such tags must be specified in the following
+global settings:
+
+- `resource.limit.host.tags` -  A comma-separated list of tags for host resource limits. It applies to resource types - User VM, CPU, Memory.
+- `resource.limit.storage.tags` - A comma-separated list of tags for storage resource limits. It applies to resource types - Volume, Primary storage.
+
+The limits for tagged resources are a subset of the overall limits and the maximum
+can be the value of the overall limit for the particular resource type.
+
+|accountlimits.png|
+
+The administrator can view used and available capacity of such tagged resource
+along with the overall capacities in the zone and cluster view in the UI.
+
+|zonecapacities.png|
+
 
 User Permission
 ~~~~~~~~~~~~~~~
@@ -931,3 +948,7 @@ aggregation.
 
 .. |editbutton.png| image:: /_static/images/edit-icon.png
    :alt: edits the settings.
+.. |accountlimits.png| image:: /_static/images/account-limits.png
+   :alt: Configure account resource limits in UI.
+.. |zonecapacities.png| image:: /_static/images/zone-capacities.png
+   :alt: Resource capacities for a zone.

source/_static/images/zone-capacities.png

@@ -136,8 +136,9 @@ To create an Instance from a Template:
 #. Select a Template or ISO. For more information about how the Templates came
    to be in this list, see `*Working with Templates* <templates.html>`_.
 
-#. Be sure that the hardware you have allows starting the selected
-   service offering.
+#. Select a service offering. Be sure that the hardware you have allows starting the selected
+   service offering. If the selected template has a tag associated with it
+   then only supported service offerings will be available for the selection.
 
 #. Select a disk offering.