diff --git a/docs/projects/ansible/collection/centurion/playbooks/index.md b/docs/projects/ansible/collection/centurion/playbooks/index.md index 34813d3..b7ee97a 100644 --- a/docs/projects/ansible/collection/centurion/playbooks/index.md +++ b/docs/projects/ansible/collection/centurion/playbooks/index.md @@ -8,4 +8,5 @@ about: https://github.com/nofusscomputing/ansible_collection_centurion Available playbooks include: +- [Inventory](./inventory.md) - [Teams](./teams.md) diff --git a/docs/projects/ansible/collection/centurion/playbooks/inventory.md b/docs/projects/ansible/collection/centurion/playbooks/inventory.md new file mode 100644 index 0000000..acfa78b --- /dev/null +++ b/docs/projects/ansible/collection/centurion/playbooks/inventory.md @@ -0,0 +1,32 @@ +--- +title: Inventory +description: Inventory host machines and publish to Centurion ERP +date: 2024-08-19 +template: project.html +about: https://github.com/nofusscomputing/ansible_collection_centurion +--- + +The inventory playbook has been created to inventory host machines and to publish the collected inventory to Centurion ERP. The inventory includes details of all software packages installed on the host machine as well as some details regarding the host machine such as UUID and serial number. + +The inventory playbook includes the [AWX Feature](../../../playbooks/awx.md) to import the playbook as a job template in AWX / Ansible Automation Platform. + +The following job template will be created: + +* **Centurion/ITAM/Inventory** Inventory host machines and publish to Centurion ERP + +On import to AWX / Ansible Automation Platform a credential type will also be created, 'Collection/No Fuss Computing/Centurion/API' that can be used to supply the required secrets and Centurion host. + + +!!! warning + The inventory playbook currently has an issue relating to gathering software starting with L. This issue has been reported and is being worked on https://github.com/nofusscomputing/ansible_collection_centurion/issues/19 + + +## Play workflow + +The inventory playbook conducts the follwoing tasks: + +- Gathers host information +- Gathers sofware information +- POSTS an inventory report to Centurion ERP +- Cleans any leftover files used to create the reports + diff --git a/mkdocs.yml b/mkdocs.yml index 43dfa44..678296c 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -32,6 +32,8 @@ nav: - Playbooks: - projects/ansible/collection/centurion/playbooks/index.md + + - projects/ansible/collection/centurion/playbooks/inventory.md - projects/ansible/collection/centurion/playbooks/teams.md