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.
Chris Dent 176524643d Documentation cleanup: front page 4 years ago
api-ref Fix aggregate members in nested alloc candidates 4 years ago
doc Documentation cleanup: front page 4 years ago
etc/placement Fix genpolicy tox job 4 years ago
gate Add trait query to placement perf check 4 years ago
placement Merge "Consider root id is None in the database case" 4 years ago
releasenotes Add placement-status upgrade check command 4 years ago
tools Added alembic environment 4 years ago
.coveragerc Use both unit and functional for coverage testing 4 years ago
.gitignore Clean up .gitignore file 4 years ago
.gitreview Set up initial .zuul.yaml 4 years ago
.stestr.conf Put stestr group_regex in .stestr.conf 4 years ago
.zuul.yaml Remove build-openstack-api-ref jobs 4 years ago
CONTRIBUTING.rst Update links in documents 5 years ago
HACKING.rst Update the HACKING.rst file 4 years ago
LICENSE initial commit 13 years ago
README.rst Update README to warn of status 4 years ago
babel.cfg Get rid of distutils.extra. 11 years ago
bindep.txt Merge "Bindep does not catch missing libpcre3-dev on Ubuntu" 5 years ago
lower-constraints.txt Add placement-status upgrade check command 4 years ago
requirements.txt Add placement-status upgrade check command 4 years ago
setup.cfg Add placement-status upgrade check command 4 years ago Updated from global requirements 6 years ago
test-requirements.txt Update requirements and test-requirements 4 years ago
tox.ini Merge "Reduce max-complexity to 15" 4 years ago


Warning: This repository is currently in a state of flux as the placement service is extracted from nova. While that is happening this repository is not yet fully working.

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 the time being bugs in placement should be created in the Nova bug tracker with a tag of ``placement``.


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

Any new code must follow the development guidelines detailed in the HACKING.rst file, and pass all tests.

Further developer focused documentation is available at: