cinder/doc/source/cli
Gorka Eguileor b50a571374 Add quota utils to cinder-manage
We have many issues with quota:

- Wrong values caused by race conditions
- Duplicated quota usage entries caused by race conditions
- Code that doesn't clean quota usage

Our current code has mechanisms to automatically refresh these values,
but there could be admins that don't want to enable it all the time, and
others that will be affected by bug #1697906 and cannot enable it.

There are a couple of scripts available online, but they all have their
issues: Not taking into account config option no_snapshot_gb_quota, not
fixing backups and groups, being racy, etc.  Moreover, they are external
tools to the OpenStack community.

We will eventually fix quotas, but in the meantime we should provide a
tool to help administrators manage the situation.

This patch adds a new 'quota' category to cinder-manage and two actions
'check' and 'sync' to allow administrators to check and fix on demand
the status of quotas (for a single or all projects).

Related-Bug: #1869749
Related-Bug: #1847791
Related-Bug: #1733179
Related-Bug: #1877164
Related-Bug: #1484343
Change-Id: Ic9323f8cfd75c0fbc425ddc9c9b35959fbe7d482
2021-03-30 16:20:35 +02:00
..
README.rst [Docs] Add documentation contribution docs 2017-08-10 15:52:46 -05:00
cinder-manage.rst Add quota utils to cinder-manage 2021-03-30 16:20:35 +02:00
cinder-status.rst Fix duplicated words issue like " should should " 2020-01-06 10:53:18 +08:00
cli-cinder-quotas.rst Docs: Make links more robust 2019-08-10 10:49:23 +02:00
cli-cinder-scheduling.rst Make doc/source directory compliant with design in spec 2017-07-19 15:59:02 -05:00
cli-manage-volumes.rst Merge "Change the CLI document for the extend-attached-volume" 2021-02-03 18:34:23 +00:00
cli-set-quotas.rst Make doc/source directory compliant with design in spec 2017-07-19 15:59:02 -05:00
index.rst Base framework for cinder-status upgrade check 2018-10-17 11:51:04 -04:00

README.rst

Cinder CLI Documentation (source/cli)

Introduction:

This directory is intended to hold any documentation that relates to Cinder's Command Line Interface. Note that this directory is intended for basic descriptions of the commands supported, similar to what you would find with a 'man page'. Tutorials or step-by-step guides should go into 'doc/source/admin' or 'doc/source/user' depending on the target audience.

The full spec for organization of documentation may be seen in the OS Manuals Migration Spec <https://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html>.