Version information
released Aug 19th 2017
This version is compatible with:
- Puppet Enterprise 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.4.x
- Puppet >= 4.9.0
Start using this module
Add this module to your Puppetfile:
mod 'choria-mcollective_choria', '0.1.0'Learn more about managing modules with a PuppetfileDocumentation
choria/mcollective_choria — version 0.1.0 Aug 19th 2017
mcollective_choria
Table of Contents
Overview
A distribution of plugins for MCollective designed to give a very smooth and streamlined experience in getting started when using the Puppet 4 AIO connected to a Puppet Server.
The main goal is ease of use and setup while remaining secure. It shares a security model with Puppet and reuse certificates made using the PuppetCA everywhere.
Includes:
- A flexible Playbook system that can integrate MCollective with many other systems
- An Orchestrator for the Puppet Multi Node Applications
- A Security Plugin for AIO Puppet including a tool to make client certificates
- A Connector using NATS.io
- A Discovery plugin for PuppetDB
- Shared configuration of SSL and other properties
- Support for SRV records for configuration to atain a zero config setup
- Every component uses strong SSL encryption that cannot be disabled.
See choria.io for full details
Module Description
## Usage
A deployment guide can be found at the Choria Website
Data Reference
mcollective_choria::gem_dependencies- Deep Merged Hash of gem name and version this module depends onmcollective_choria::manage_gem_dependencies- disable managing of gem dependenciesmcollective_choria::package_dependencies- Deep Merged Hash of package name and version this module depends onmcollective_choria::manage_package_dependencies- disable managing of packages dependenciesmcollective_choria::class_dependencies- Array of classes to include when installing this modulemcollective_choria::package_dependencies- disable managing of class dependenciesmcollective_choria::config- Deep Merged Hash of common config items for this modulemcollective_choria::server_config- Deep Merged Hash of config items specific to managed nodesmcollective_choria::client_config- Deep Merged Hash of config items specific to client nodesmcollective_choria::client- installs client files when true - defaults to$mcollective::clientmcollective_choria::server- installs server files when true - defaults to$mcollective::servermcollective_choria::ensure-presentorabsent
| Date | Issue | Description |
|---|---|---|
| 2017/08/19 | Release 0.1.0 | |
| 2017/08/19 | 290 | Strip spaces off comma separated host lists to allow for space between hosts |
| 2017/08/18 | 314 | Fix fact filters in JSON transport mode |
| 2017/08/18 | 307 | When the client is run as root raise an informative error rather than fail silently |
| 2017/08/16 | 308 | Remove hard dependency on ajcrowe/supervisord |
| 2017/08/11 | 310 | Support dot notation for facts when using choria discovery method |
| 2017/08/09 | 192 | Add an assert option to the mcollective task using JGrep, deprecate mcollective_assert |
| 2017/08/02 | 305 | Handle the case where node inventory data is JSON encoded correctly in playbooks |
| 2017/08/02 | Release 0.0.28 | |
| 2017/07/27 | 301 | Support using supervisord to manage the federation brokers |
| 2017/08/02 | 298 | Update nats-pure gem to 0.2.4 |
| 2017/06/30 | 296 | Use base64 not hex encoding for reply hashes |
| 2017/06/18 | 288 | Serialize the innermost body seperately from the container messages |
| 2017/06/01 | Release 0.0.27 | |
| 2017/06/01 | 267 | Support a pure JSON transport in preparation for a upcoming MCollective release |
| 2017/06/01 | 273 | Correctly report paths when doing a federation trace to the host the client runs on |
| 2017/05/28 | 274 | Update for version 5 of Hiera and require Puppet >= 4.9.0 |
| 2017/05/22 | 271 | Support Choria Discovery Proxy |
| 2017/05/08 | 265 | Consult choria.puppetca_port configuration when resolving the CA |
| 2017/05/04 | 152 | Add a etcd data store |
| 2017/04/19 | 258 | Show the embedded certname and compare it with the configured certname |
| 2017/04/18 | Release 0.0.26 | |
| 2017/04/18 | 254 | Improve sanity checks done when validating the overall SSL setup |
| 2017/04/12 | 248 | Allow cert validation to be disabled in webhook |
| 2017/04/12 | 250 | Accept http code 201 as a valid return code for the webhook playbook task |
| 2017/03/30 | 212 | Add batch_sleep_time to mcollective playbook task |
| 2017/03/30 | 244 | Show correct PuppetDB information in mco choria show_config |
| 2017/03/30 | 243 | Show the Choria version in mco choria show_config |
| 2017/03/29 | Release 0.0.25 | |
| 2017/03/27 | 228 | Support Federations of Collectives |
| 2017/03/14 | 229 | Update the NATS gem to 0.2.2 |
| 2017/03/11 | 213 | Add federation support to the NATS connector |
| 2017/03/08 | Release 0.0.24 | |
| 2017/03/07 | 204 | Add a choria_util agent that extract running info out of the mcollective daemon |
| 2017/03/06 | 173 | Support playbook elapsed time in templates |
| 2017/03/06 | 201 | Allow server randomization to be configured |
| 2017/02/16 | 199 | Use the configured ssl_dir for storing the public cert cache |
| 2017/02/19 | 186 | Add a Graphite event task |
| 2017/02/17 | Release 0.0.23 | |
| 2017/02/14 | 193 | Improve support for custom CAs by making x509 subject parsing more robust |
| 2017/02/14 | 191 | Add the mco choria show_config command to inspect active Choria configuration |
| 2017/02/13 | 187 | Support {{ ... }} as well as {{{ ... }}} in templates |
| 2017/02/13 | 177 | Add a shell script based data store |
| 2017/02/12 | Release 0.0.22 | |
| 2017/02/11 | 181 | Add a registration plugin |
| 2017/02/09 | 176 | Create the choria public certs in the right directory on windows |
| 2017/02/06 | 174 | Set the mcollective summary as task outcome when its requested |
| 2017/01/31 | 135 | Add a choria logo to the slack task user |
| 2017/01/29 | Release 0.0.21 | |
| 2017/01/29 | 161 | Improve validation for node lists in the mcollective task |
| 2017/01/27 | 165 | Create environment and file data stores |
| 2017/01/27 | 166 | Improve validation of the playbook data |
| 2017/01/26 | 160 | Fix inputs like :array and a few other types |
| 2017/01/26 | 163 | Ensure templates are parsed in task descriptions |
| 2017/01/23 | Release 0.0.20 | |
| 2017/01/23 | 151 | Add a Consul data source |
| 2017/01/21 | 155 | Allow inputs to be forced to dynamic only inputs |
| 2017/01/21 | 149 | Support data sources, dynamic inputs, data source read and write tasks |
| 2017/01/13 | Release 0.0.19 | |
| 2017/01/13 | 147 | Add a color option to the slack task and make it generally prettier |
| 2017/01/13 | 145 | Improve file name handling for reports |
| 2017/01/13 | 143 | Always use the identity cert on windows |
| 2017/01/12 | Release 0.0.18 | |
| 2017/01/12 | Release 0.0.17 | |
| 2017/01/12 | Release 0.0.16 | |
| 2017/01/12 | 88 | Add playbook reports |
| 2017/01/11 | 101 | Expose previous task status via templates |
| 2017/01/07 | 129 | Add a choria audit plugin that logs in JSON format |
| 2017/01/04 | 127 | Allow SRV record support to be disabled |
| 2017/01/03 | Release 0.0.15 | |
| 2017/01/03 | 125 | Adjust dependencies so these modules work with librarian |
| 2016/12/31 | Release 0.0.14 | |
| 2016/12/31 | 106 | Update the NATS gem to 0.2.0 |
| 2016/12/29 | 117 | When both a PuppetDB SRV record and a Puppet one existed results were randomly chosen hosts |
| 2016/12/29 | 118 | Support UUID and time stamps in templates |
| 2016/12/29 | Release 0.0.13 | |
| 2016/12/28 | 113 | Add a terraform node set |
| 2016/12/28 | 96 | Add a webhook task used to GET and POST to other systems |
| 2016/12/27 | 109 | Add a mcollective_assert task used to check or wait for certain states |
| 2016/12/26 | 102 | Support arguments to commands ran by the shell node set in playbooks |
| 2016/12/26 | Release 0.0.12 | |
| 2016/12/26 | 104 | Support posting messages to slack as a task step |
| 2016/12/25 | 95 | Support running shell commands as task steps |
| 2016/12/25 | 94 | Support YAML files as node set source in Playbooks |
| 2016/12/25 | 93 | Support shell commands as node set source in Playbooks |
| 2016/12/25 | 92 | Support PQL queries as node set source in Playbooks |
| 2016/12/25 | 32 | Add a Playbook system |
| 2016/12/16 | Release 0.0.11 | |
| 2016/12/16 | 83 | Fix a bug introduced during #55 where Puppet was not correctly initialized |
| 2016/12/13 | Release 0.0.10 | |
| 2016/12/11 | 48 | Use the new Pure Ruby NATS gem and remove EM |
| 2016/11/19 | 55 | When root consult Puppet configuration to find the SSL dir, make ssl dir configurable |
| 2016/11/19 | 68 | Update eventmachine to 1.2.1 and install that by default, improve logging of EM mode and version |
| 2016/11/01 | Release 0.0.9 | |
| 2016/10/20 | 61 | Support PQL queries on the CLI for node discovery |
| 2016/10/07 | 59 | Reqiure missing resolv dependency |
| 2016/09/12 | 56 | Filter out deactivated nodes from discovery results |
| 2016/08/22 | 35 | Simplify facts queries using latest PuppetDB PQL |
| 2016/08/20 | 52 | Release 0.0.8 |
| 2016/08/19 | 49 | Set the connection name |
| 2016/08/19 | 42 | Support NATS gem 0.8.0 and log connected NATS brokers |
| 2016/08/13 | Release 0.0.7 | |
| 2016/08/13 | 45 | Fix calling facter on windows |
| 2016/08/11 | Release 0.0.6 | |
| 2016/08/10 | 34 | Correctly declare Apache-2.0 licence |
| 2016/08/10 | 37 | Improve errors when a empty site catalog is found |
| 2016/08/01 | Release 0.0.5 | |
| 2016/08/01 | 29 | Fix discovery of rpcutil and subclasses |
| 2016/08/01 | Release 0.0.4 | |
| 2016/08/01 | 27 | Install client files only on clients and not everywhere |
| 2016/08/01 | 27 | Improve discovery of agents in cases where there are client only installs |
| 2016/07/29 | 22 | Improve handling of errors from the nodes |
| 2016/07/26 | 20 | Fix incorrect module data |
| 2016/07/23 | 10 | Import mcollective-connector-nats |
| 2016/07/23 | 8 | Import mcollective-discovery-puppetdb as choria discovery provider |
| 2016/07/23 | 3 | Import mcollective-security-puppet as choria security provider |
| 2016/07/22 | 4 | Move orchestrator into a class of its own, add tests |
| 2016/07/22 | 1 | Detect cyclic catalogs |
Dependencies
- choria/mcollective (>= 0.0.26 < 2.0.0)
- choria/mcollective_agent_puppet (>= 1.12.0)
- choria/mcollective_agent_package (>= 4.5.0)
- choria/mcollective_agent_service (>= 3.1.3)
- choria/mcollective_agent_filemgr (>= 1.1.0)
- choria/mcollective_util_actionpolicy (>= 2.1.0)
- choria/nats (>= 0.0.6)
- camptocamp/systemd (>= 0.3.0 < 1.0.0)