Gluware Ansible Inventory
Project description
Gluware Ansible Inventory (Inventory plugin and Gluware Ansible modules)
This python package installs a Ansible Inventory plugin (glu_devices) to interact with a Gluware Control system to get the current network devices of a organization. A "inventory" user can be created in the Gluware Control system that can then be used in the configuration of the glu_devices inventory plugin to access the devices of the Gluware Control system.
The glu_devices Ansible Inventory plugin gives Ansible playbooks the ability to connect to Gluware devices and get the "ansible_network_os" property of the device to know what kind of device it is (if the discovery function in Gluware is used). The glu_devices inventory plugin also exposes to Ansible playbooks any custom Gluware device attributes that start with "ansible_var_" (minus the "ansible_var_" part) to act on within the logic of the playbook. In addition, the other Gluware device attributes can be mapped to Ansible variables through configuration settings of the glu_devices.
In version 1.2, Gluware Ansible modules are also installed to allow interaction with Gluware device data from within playbook tasks. The Inventory plugin was updated to supply the 'glu_device_id' for the Gluware Ansible modules. The modules are identified as follows:
- glu_audit_config
- Perform a audit on the current captured config on a Gluware Device
- glu_capture_config
- Perform a capture config on a Gluware Device
- glu_run_discover_device_attributes
- Perform a discover device attributes on a Gluware Device
- glu_update_device_attributes
- Update device attributes on a Gluware Device
To install on the system that is running Ansible run the command line: "pip install gluware-ansible-inventory". If updating to a later version the run the command line: "pip install -I gluware-ansible-inventory".
After install run the command line: "ansible-doc -t inventory glu_devices" to see the specifics of how to use the glu_devices inventory plugin to connect to the Gluware Control system. To see the documentation for each module run the command line: "ansible-doc -t module {{ module_name }}".
-
Install Command
- $ pip install gluware-ansible-inventory
-
Update Command:
- $ pip install -I gluware-ansible-inventory
-
Usage documentation command after install
- $ ansible-doc -t inventory glu_devices
- $ ansible-doc -t module glu_audit_config
- $ ansible-doc -t module glu_capture_config
- $ ansible-doc -t module glu_run_discover_device_attributes
- $ ansible-doc -t module glu_update_device_attributes
-
Installation imlementation note:
- The 'pip install gluware-ansible-inventory' places the 'glu_devices.py' file in the '/usr/share/ansible/plugins/inventory/' directory for ansible to find the glu_devices inventory plugin. The modules are placed in the '/usr/share/ansible/plugins/modules/' directory for ansible to find the Gluware modules.
- The inventory plugin is just the 'glu_devices.py' file with no other files being used.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for gluware-ansible-inventory-1.2.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a2f89d8eea274ff6c8c952f8f5779b47f9702691690d60c6f7ff14bce1cf8087 |
|
MD5 | 1f564ab8e9a07a960a3799d540d62285 |
|
BLAKE2b-256 | 185679cd424aa070a97ec3d3b121b1c8356ce0a7605c759060f036359b06a378 |