External-Mirrors/awx
2
0
Fork 0
mirror of https://github.com/ansible/awx.git synced 2026-01-15 03:40:42 -03:30
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #7071 from wwitzel3/devel

Browse Source 
Update inventory_refresh acceptance docs
This commit is contained in:
Wayne Witzel III 2017-07-14 10:44:11 -04:00 committed by GitHub
commit 2f82b3742d
1 changed files with 12 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/inventory_refresh.md
View File

@ -53,9 +53,12 @@ is the combination that makes a _Smart Inventory_.
* `Host` model has a new field called `smart_inventories`. This field uses the `SmartInventoryMemberships`
lookup table to provide a set of all of the _Smart Inventory_ a host is a part of. The memberships
are generated by the `update_host_smart_inventory_memberships` task. This task is called when the view for
`/api/v2/hosts/:id/smart_inventories` is materialized. NOTE: This task is only run if the
`AWX_REBUILD_SMART_MEMBERSHIP` is set to True. It defaults to False.
are generated by the `update_host_smart_inventory_memberships` task. The task is launched when:
* New Host is added.
* Existing Host is changed (update/delete).
* New Smart Inventory is added.
* Existing Smart Inventory is changed (update/delete).
* NOTE: This task is only run if the `AWX_REBUILD_SMART_MEMBERSHIP` is set to True. It defaults to False.
### Smart Filter (host_filter)
The `SmartFilter` class handles our translation of the smart search string. We store the
@ -99,14 +102,18 @@ hosts with a name containing "nyc".
### Acceptance Critera
When verifying acceptance we should ensure the following statements are true:
``
* `Inventory` has a new field named `kind` that defaults to empty and
can only be set to `smart`.
* `Inventory` has a new field named `host_filter` to empty and can only be
set to a valid _SmartFilter_ string.
* `Inventory` with a `host_filter` set and a `kind` of `smart` will have
a `hosts` list reflecting the results of searching `/api/v2/hosts` with the same
* `Inventory` with a `host_filter` set and a `kind` of `smart`:
* `hosts` list reflecting the results of searching `/api/v2/hosts` with the same
search that is set in the `host_filter`.
* Not allow creation of Hosts
* Not allow creation of Groups
* Not allow creation of Inventory Sources
### API Concerns
There are no breaking or backwards incompatible changes for this feature.