This is an [Ansible] plugin to manage your Ansible inventory over at [Server Density]. It uses the [ServerDensity API] and the [Ansible API].
##Features##
The following objects can be created and updated in your Server Density account from within Ansible:
* Hosts/Devices with groups
* Services with groups
* Alerts for
* Devices
* Device Groups
* Services
* Service Groups
* Notifications for alerts
There are plugin parameters to define how the plugin will behave:
***api_token**: An API token from Server Density to authenticate yourself
***force** (optional, defaults to False): If an object already exists whether it should be updated
***cache** (optional, defaults to None): Fully qualified filename for a cache of der Server Density data
***cleanup** (optional, defaults to False): Decides if undefined alerts in your Ansible inventory available at Server Density should be deleted
***readonly** (optional, defaults to False): If set to True it will only read the current settings from SD and stores them in a temporary file and does nothing else. This is useful when you want to find out some variable names for alerts or similar things
***output** (optional, defaults to False): If provided, all current settings that are currently set upstream at Server Density will be written in YAML to this file
##Installation##
Download (or clone) the file `serverdensity.py` from the `action_plugins` directory and copy that into your custom action plugins directory which is defined in `/etc/ansible/ansible.cfg`. The default location for this is `/usr/share/ansible_plugins/action_plugins`
##Usage##
This plugin can be used in playbooks or with the ansible script directly.
###In Playbooks###
Simply include a task like this:
```
- name: ServerDensity | Init SD plugin
local_action: serverdensity
api_token={{sd_api_token}}
cleanup=true
cache='/tmp/my_sd_cache'
```
You may also be interested in the [Server Density Role] that I've written which in addition installs and configures the Server Density agent on your hosts and synchronizes your inventory with Server Density by utilizing this plugin.
###From the ansible script###
Your whole inventory gets synchronized with Server Density simply by using this command:
```
ansible all -m serverdensity -a 'api_token=YOUR_SD_TOKEN' -vv
```
The final -vv parameter is inhancing the level of output on the console and with this plugin you'll get some quite useful information on what's going on in detail.
##Configuration##
The following variables are required in order to use this plugin and you should define them somewhere in you inventory, e.g. in group_vars/all. Further configuration for device groups, services and alerts can be defined in variables too and they are fully documented in the [Wiki].
###sd_url###
Defines the Server Density URL of your account, e.g. ```'https://myaccount.serverdensity.io'```
