Skip to content

Commit 255a4fb

Browse files
Documentation: Added short, plain walkthrough of using inventory plugin within AWX/Tower (#182)
1 parent df0a6cf commit 255a4fb

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

README.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -165,6 +165,19 @@ Using the **collections** lookup plugin at the task level
165165
query_result: "{{ query('nb_lookup', 'sites', api_endpoint='http://localhost:32768', token='0123456789abcdef0123456789abcdef01234567') }}"
166166
```
167167
168+
### Using **nb_inventory** Within AWX/Tower
169+
170+
This will cover the basic usage of the NetBox inventory plugin within this collection.
171+
172+
1. Define `collections/requirements.yml` within a Git project.
173+
1. AWX/Tower will download the collection on each run. This can be handled differently or excluded if storing Ansible Collections on the AWX/Tower box.
174+
2. Define `inventory.yml` in Git project that adheres to inventory plugin structure.
175+
2. Add Git project to AWX/Tower as a project.
176+
3. Create inventory and select `source from project`.
177+
1. Select the AWX/Tower project from Step 2
178+
2. Select the `inventory.yml` file in the project from Step 1.1
179+
3. Click `Save` and sync source.
180+
168181
## How to Contribute
169182

170183
Please read ![Contributing](CONTRIBUTING.md)

0 commit comments

Comments
 (0)