Linchpin

This release marks some useful enhancements and features:

* Add support for passing instance_tags for aws driver. (541)
* Add name in topology for bkr_server, os_server, aws_ec2 resources, include in distilled data (550)
* Add auto_ip option to os_server resources (552)
* Add security_group as a list to aws_ec2 resources (557)

Additional bugs were also fixed along the way:

* linchpin up AWS target fails when using CREDS_PATH (497)
* use match instead of equalto for rhel7/centos7 (537)
* Fix TypeError when missing template-data (539)
* Fixup reporting issues, other minor fixes (565)
* removed errant if/else which was providing incorrect return code output to the user
* Add no_log in a few places which would display sensitive data
* Moved the code for distilling data into a distill_data method

Documentation was updated as well:

* Updated credentials format for all providers (514)
* Documented the Context Distiller (523)
* Documented what is required for each provider topology (487)

This release marks some useful enhancements and features:

* Allow inventory file name be specified in layout file (421)
* The Context Distiller allows a user to enable resource data to be retrieved and written to a json file (525)
* Made the 'whiteboard' variable optional in the beaker driver (518)
* Allow up/destroy actions to use rundb data (512)
* Added transaction (--view=tx) view to linchpin journal (501)
* Added support for attaching volumes to provisioned openstack instances (494)

Additional bugs were also fixed along the way:

* linchpin destroy fails for AWS aws (495)
* Enable linchpin journal without target (475)
* Allow passing provisioning options through to bkr_info (468)

Documentation was updated as well:

* Documented the RunDB json and its purpose (506)
* Fixed broken links to source for bkr_info and bkr_server on readthedocs (517)

This release has the following updates:

* The command line shell now enables ansible verbose output (456)
* Made the uHash optional for instances and inventory files (458)
* Adjusted the default location of the RunDB to the workspace (458)
* General cleanup (461)
* Update the README
* Remove references to outdated documentation.
* Remove unused schemas and documentation.
* Fixed documentation example links (453)
* Make generating resources optional (462)
* Additional libvirt updates (464)
* Add detail about libvirt and image copying rights to Provider doc
* Libvirt supports 'become' functionality as an unprivileged user
* Additional Documentation improvements to Getting Started Guide (464)
* Updated `mkvirtualenv` docs to point out the ``-p`` switch for newer distros with Python 3.x installed
* Made aws topology option `keypair` optional (466)
* Linchpin's configuration file (linchpin.conf), has been converted into linchpin.constants. (460)
* The linchpin.conf continues to work as normal, with the added benefit of overwriting single configuration values

This release marks some major enhancements and features:

* Reworked provider roles
* Each Provider is a well-defined set of Ansible playbooks, which are called by the LinchPin API
* `resource_definitions` are validated based upon the `resource_group_type` keyword
* Each Provider contains its own schema, found in ``roles/<provider>/files/schema.json``
* Each Provider also has a playbook named based upon the `resource_group_type`, which the LinchPin API uses to call the proper playbook
* For Providers which didn't have a `resource_definitions` section, LinchPin will convert it for backward compatibility.
* Schema validation is done using the [cerberus](http://docs.python-cerberus.org/en/stable/) json validator, replacing the jsonschema validator
* Validation is done at provision time, rather than initially. This provides a useful mechanism to provide a flag for skipping a provision in the future if one doesn't validate.
* Instead of using a giant single schema (or currently two (2) schemas, each resource has its own set that can be updated independently when something changes.
* New API layout
* Provides a more flexible way for developers to use the LinchPin API
* Specifically separates out the CLI bits from the central API
* Adds a linchpin.shell reference implementation of the linchpin.cli API for the command-line interface
* Simplifies the central API into a single call for any action on any resource
* Allow external providers
* In some cases, it may be advantageous to create a set of Ansible Playbooks which can be validated and called via LinchPin. In this way, with a small modification to the configuration, a Developer can create their own provider to use with LinchPin. A developer could even create a replacement for a deficiency in one of the built-in providers.
* Dynamic Input and Templating
* PinFile can include topology and layout data inline
* PinFile can be dynamically created from an external script
* Using Jinja2 and yaml/json template data, a LinchPin command-line shell user can create any PinFile structure
* Jinja2 and template data can be used in the PinFile, topology, or layout files
* Declaring Hooks can be dynamic, but the hooks themselves do not support Jinja2
* A generated PinFile can be saved to an external file prior to provisioning
* Documentation rework
* Rewrote 80+% of the documentation
* Reworked the examples to use ones that are tested regularly
* Better Getting Started Guide
* Improved Installation Guide, with real world examples
* Detailed configuration options
* Created command-line tools documentation
* Documented Providers on a separate page with details around dependencies, credentials, and other uniqueness
* Explained the new PinFile, topology, and layout formats, and included examples

Bug fixes in this release:

* Partial completion of beaker provision results in no inventory file 289
* Create inception-based testing for libvirt functionality enhancement 158
* Many thanks to p3ck for creating container-based tests for many of the major distros, and for testing libvirt, duffy, and dummy modules. More to come!
* fails on centos6 405

v1.5.0 is not yet formally released. This is release candidate 1 (rc1) for review and feedback.

Details of features and improvements are as follows:

* API rewrite - LinchpinAPI class now simpler, calls playbooks based upon resource_group_type
* Dynamic Input - Scripted input via STDIN is acceptable
* PinFile, topology, and layout templating using Jinja2
* Optional flag for generated PinFile to be output to a file
* Large update to documentation
* Still in process, available at http://herlo-linchpin.readthedocs.io/en/release1.5/

Bugfixes are as follows:

* Bugfix - Ensure rundb path

The following were updated/fixed in this release:

* Bugfix: Added missing quotes in network attribute
* Bugfix: Make the 'delete associated images' part actually work
* Added bridge parameter to libvirt_network provisioning
* Add dependencies to make libvirt provisioning work (testing)
* Bugfix: Fix 411 using os.makedirs instead of os.mkdir
* Bugfix: updated URI for Provisioning when cloudconfig is not defined