openstack
/
placement
Code Issues Proposed changes
OpenStack resource provider inventory allocation service
11,622 Commits 9 Branches 46 Tags 21 MiB
Python 93%
PHP 4.3%
Shell 2.6%
Go to file
Balazs Gibizer 1164497964 Clarify trait filtering in the API doc 
Based on the spec[1], the user doc[2] and the implementation[3][4]
the original intention of trait filtering during allocation
candidate query is that the required traits in the unnamed group
needs to be provided by the resource providers contributing resources
to the candidate. So traits on RPs which are in the tree of the
candidate but not providing resource to the candidate should be ignored.

The current API doc is not clear on this and can be misunderstood. So
this patch clarifies that doc.

[1] https://docs.openstack.org/placement/latest/specs/train/implemented/2005575-nested-magic-1.html
[2] https://docs.openstack.org/placement/latest/user/provider-tree.html#filtering-by-traits
[3] d48d22ff24/placement/objects/research_context.py (L745)
[4] d48d22ff24/placement/tests/functional/db/test_allocation_candidates.py (L817-L827)

Story: #2009795
Task: #44334
Change-Id: Idc367df609dc8d4874fc329f2317c582b9e06a4d
 		2022-08-03 15:21:45 +02:00
api-ref Clarify trait filtering in the API doc 2022-08-03 15:21:45 +02:00
doc Add WA about resource_providers.can_host removal 2022-06-14 13:33:43 +02:00
etc/placement Enable HTTPProxyToWSGI middleware to find actual client ips 2021-08-01 20:56:44 +09:00
gate Make perfload jobs fail if write allocation fails 2022-04-01 23:40:33 +00:00
placement Update placement for os-traits 2.8.0 release 2022-08-02 17:52:46 +10:00
placement_db_tools Add --skip-locks flag to mysql-migrate-db.sh 2019-10-07 09:59:07 -04:00
playbooks Move non-nested perfload shell commands to script 2019-06-20 12:38:08 +01:00
releasenotes Merge "doc: Comment out language option" 2022-08-02 14:43:32 +00:00
tools [goal] Migrate testing to ubuntu focal 2020-08-16 21:07:26 +00:00
.coveragerc Use both unit and functional for coverage testing 2018-09-14 13:30:14 -06:00
.gitignore Clean up document's index 2019-09-24 15:45:11 +00:00
.gitreview OpenDev Migration Patch 2019-04-19 19:41:22 +00:00
.stestr.conf Put stestr group_regex in .stestr.conf 2018-09-14 13:30:14 -06:00
.zuul.yaml Update python testing as per zed cycle testing runtime 2022-06-08 08:14:53 +09:00
CONTRIBUTING.rst [Community goal] Update contributor documentation 2020-04-21 05:45:05 +00:00
LICENSE initial commit 2010-05-27 23:05:26 -07:00
README.rst Start README.rst with a better title 2019-11-28 09:58:34 +08:00
bindep.txt Merge "Bindep does not catch missing libpcre3-dev on Ubuntu" 2018-02-14 07:31:09 +00:00
requirements.txt Update placement for os-traits 2.8.0 release 2022-08-02 17:52:46 +10:00
setup.cfg Update python testing as per zed cycle testing runtime 2022-06-08 08:14:53 +09:00
setup.py Cleanup py27 support 2020-04-07 17:30:34 +00:00
test-requirements.txt Add 'cryptography' package to test-requirements.txt 2021-04-21 01:08:38 +00:00
tox.ini Merge "Change minversion of tox to 3.18.0" 2022-06-24 11:11:22 +00:00

README.rst

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

OpenStack Placement

image

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

API

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:

Operators

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:

Developers

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

Further developer focused documentation is available at: