OpenStack resource provider inventory allocation service
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Zuul 87dfb3ad47 Merge "Update for os-traits 2.0.0" 3 days ago
api-ref Clarify GET /allocations/$c for nonexistent $c 1 month ago
doc Remove py2 specific requirement for docs 5 days ago
etc/placement Update READMEs for sample policy/config generation 2 months ago
gate Add apache benchmark (ab) to end of perfload jobs 4 months ago
placement Update for os-traits 2.0.0 3 days ago
placement_db_tools Add --skip-locks flag to 2 months ago
playbooks Move non-nested perfload shell commands to script 5 months ago
releasenotes Merge "Add allocation_conflict_retry_count conf setting" 3 weeks ago
tools Package db migration scripts in placement pypi dist 7 months ago
.coveragerc Use both unit and functional for coverage testing 1 year ago
.gitignore Clean up document's index 2 months ago
.gitreview OpenDev Migration Patch 7 months ago
.stestr.conf Put stestr group_regex in .stestr.conf 1 year ago
.zuul.yaml Drop support for python 2 1 month ago
LICENSE initial commit 9 years ago
README.rst Update api-ref location 4 months ago
babel.cfg Get rid of distutils.extra. 7 years ago
bindep.txt Merge "Bindep does not catch missing libpcre3-dev on Ubuntu" 1 year ago
lower-constraints.txt Update for os-traits 2.0.0 3 days ago
requirements.txt Update for os-traits 2.0.0 3 days ago
setup.cfg Drop support for python 2 1 month ago Updated from global requirements 2 years ago
test-requirements.txt Make placement testing easier on osx 4 months ago
tox.ini Drop support for python 2 1 month ago


If you are viewing this README on GitHub, please be aware that placement development happens on OpenStack git and OpenStack gerrit.

Team and repository tags


OpenStack Placement

OpenStack Placement provides an HTTP service for managing, selecting, and claiming providers of classes of inventory representing available resources in a cloud.


To learn how to use Placement's API, consult the documentation available online at:

For more information on OpenStack APIs, SDKs and CLIs in general, refer to:


To learn how to deploy and configure OpenStack Placement, consult the documentation available online at:

In the unfortunate event that bugs are discovered, they should be reported to the appropriate bug tracker. If you obtained the software from a 3rd party operating system vendor, it is often wise to use their own bug tracker for reporting problems. In all other cases use the master OpenStack bug tracker, available at:


For information on how to contribute to Placement, please see the contents of CONTRIBUTING.rst.

Further developer focused documentation is available at: