.fixtures-latest.yml

@@ -7,6 +7,14 @@ fixtures:
     yumrepo_core:
       repo: git://github.com/puppetlabs/puppetlabs-yumrepo_core
       puppet_version: ">= 6.0.0"
+    chocolatey:
+      repo: git://github.com/puppetlabs/puppetlabs-chocolatey.git
+    # Needed by chocolatey
+    registry:
+      repo: git://github.com/puppetlabs/puppetlabs-registry.git
+    # Needed by chocolatey
+    powershell:
+      repo: git://github.com/puppetlabs/puppetlabs-powershell.git
     # Need by postgresql
     augeas_core:
       repo: git://github.com/puppetlabs/puppetlabs-augeas_core

.fixtures.yml

@@ -10,6 +10,17 @@ fixtures:
       repo: git://github.com/puppetlabs/puppetlabs-yumrepo_core
       ref: 1.0.1
       puppet_version: ">= 6.0.0"
+    chocolatey:
+      repo: git://github.com/puppetlabs/puppetlabs-chocolatey.git
+      ref: 3.0.0
+    # Needed by chocolatey
+    registry:
+      repo: git://github.com/puppetlabs/puppetlabs-registry.git
+      ref: 1.0.0
+    # Needed by chocolatey
+    powershell:
+      repo: git://github.com/puppetlabs/puppetlabs-powershell.git
+      ref: 1.0.1
     # Need by postgresql
     augeas_core:
       repo: git://github.com/puppetlabs/puppetlabs-augeas_core

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Change Log
 
+## [v3.9.0](https://github.com/sensu/sensu-puppet/tree/v3.9.0) (2019-10-10)
+[Full Changelog](https://github.com/sensu/sensu-puppet/compare/v3.8.0...v3.9.0)
+
+**Merged pull requests:**
+
+- Add sensu\_resources type that will handle resource purging [\#1158](https://github.com/sensu/sensu-puppet/pull/1158) ([treydock](https://github.com/treydock))
+- Add sensu\_gem package provider [\#1156](https://github.com/sensu/sensu-puppet/pull/1156) ([treydock](https://github.com/treydock))
+- Install Windows agent via chocolatey [\#1152](https://github.com/sensu/sensu-puppet/pull/1152) ([treydock](https://github.com/treydock))
+- Fix Puppet strings warnings [\#1150](https://github.com/sensu/sensu-puppet/pull/1150) ([treydock](https://github.com/treydock))
+- Add sensu\_bonsai\_asset type [\#1149](https://github.com/sensu/sensu-puppet/pull/1149) ([treydock](https://github.com/treydock))
+- Fix sensu\_plugin version insync? check [\#1148](https://github.com/sensu/sensu-puppet/pull/1148) ([treydock](https://github.com/treydock))
+- Replace unit test instance variables with let [\#1143](https://github.com/sensu/sensu-puppet/pull/1143) ([treydock](https://github.com/treydock))
+
 ## [v3.8.0](https://github.com/sensu/sensu-puppet/tree/v3.8.0) (2019-09-02)
 [Full Changelog](https://github.com/sensu/sensu-puppet/compare/v3.7.0...v3.8.0)
 

README.md

@@ -24,6 +24,7 @@
         * [Adding backend members to an existing cluster](#adding-backend-members-to-an-existing-cluster)
     * [Large Environment Considerations](#large-environment-considerations)
     * [Composite Names for Namespaces](#composite-names-for-namespaces)
+    * [Installing Bonsai Assets](#installing-bonsai-assets)
 4. [Reference](#reference)
     * [Facts](#facts)
 5. [Limitations - OS compatibility, etc.](#limitations)
@@ -69,7 +70,9 @@ This module has a soft dependency on the [puppetlabs/apt](https://forge.puppet.c
 
 If using Puppet >= 6.0.0 there is a soft dependency on the [puppetlabs/yumrepo_core](https://forge.puppet.com/puppetlabs/yumrepo_core) module (`>= 1.0.1 < 2.0.0`) for systems using `yum`.
 
-If managing Windows there is a soft dependency on the [puppet/archive](https://forge.puppet.com/puppet/archive) module (`>= 3.0.0 < 5.0.0`).
+If managing Windows there is a soft dependency on the [puppetlabs/chocolatey](https://forge.puppet.com/puppetlabs/chocolatey) module (`>= 3.0.0 < 5.0.0`).
+
+If managing Windows and defining `package_source`, there is a soft dependency on the [puppet/archive](https://forge.puppet.com/puppet/archive) module (`>= 3.0.0 < 5.0.0`).
 
 For PostgreSQL datastore support there is a soft dependency on [puppetlabs/postgresql](https://forge.puppet.com/puppetlabs/postgresql) module (`>= 6.0.0 < 7.0.0`).
 
@@ -129,22 +132,33 @@ associated to `linux` and `apache-servers` subscriptions.
 
 ### Manage Windows Agent
 
-This module supports Windows Sensu Go agent starting with version 5.7.0.
+This module supports Windows Sensu Go agent via chocolatey beginning with version 5.12.0.
+
+```puppet
+class { 'sensu::agent':
+  backends    => ['sensu-backend.example.com:8081'],
+  config_hash => {
+    'subscriptions' => ['windows'],
+  },
+}
+```
 
-The Windows package source must be specified as either a URL, a Puppet source or a filesystem path.
+If you do not wish to install using chocolatey then you must define `package_source` as either a URL, a Puppet source or a filesystem path.
 
 Install sensu-go-agent on Windows from URL:
 
 ```puppet
 class { 'sensu::agent':
-  package_source => 'https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.7.0/sensu-go-agent_5.7.0.2380_en-US.x64.msi',
+  package_name   => 'Sensu Agent',
+  package_source => 'https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.13.1/sensu-go-agent_5.13.1.5957_en-US.x64.msi',
 }
 ```
 
 Install sensu-go-agent on Windows from Puppet source:
 
 ```puppet
 class { 'sensu::agent':
+  package_name   => 'Sensu Agent',
   package_source => 'puppet:///modules/profile/sensu/sensu-go-agent.msi',
 }
 ```
@@ -153,6 +167,7 @@ If a system already has the necessary MSI present it can be installed without do
 
 ```puppet
 class { 'sensu::agent':
+  package_name   => 'Sensu Agent',
   package_source => 'C:\Temp\sensu-go-agent.msi',
 }
 ```
@@ -299,6 +314,15 @@ Set `dependencies` to an empty Array to disable the `sensu::plugins` dependency
   }
 ```
 
+If gems are required and not pulled in as gem dependencies they can also be installed.
+
+```puppet
+class { 'sensu::plugins':
+  plugins          => ['memory-checks'],
+  gem_dependencies => ['vmstat'],
+}
+```
+
 You can uninstall plugins by passing `ensure` as `absent`.
 
 ```puppet
@@ -437,9 +461,18 @@ sensu::backend::checks:
 ### Resource purging
 
 All the types provided by this module support purging except `sensu_config`.
-At this time `sensu_asset` can not be purged, see [Limitations](#limitations).
 This example will remove all unmanaged Sensu checks:
 
+```puppet
+sensu_resources { 'sensu_check':
+  purge => true,
+}
+```
+
+**NOTE**: The Puppet built-in `resources` can also be used for purging but you must ensure that resources that support namespaces are defined using composite names in the form of `$name in $namespace`. See [Composite Names for Namespaces](#composite-names-for-namespaces) for details on composite names.
+
+Using the Puppet built-in `resources` would look like this:
+
 ```puppet
 resources { 'sensu_check':
   purge => true,
@@ -548,6 +581,32 @@ The example above would add the `check-cpu` check to both the `default` and `tea
 
 **NOTE:** If you use composite names for namespaces, the `namespace` property takes precedence.
 
+### Installing Bonsai Assets
+Install a bonsai asset. The latest version will be installed but not automatically upgraded.
+
+```puppet
+sensu_bonsai_asset { 'sensu/sensu-pagerduty-handler':
+  ensure  => 'present',
+}
+```
+
+Install specific version of a bonsai asset.
+
+```puppet
+sensu_bonsai_asset { 'sensu/sensu-pagerduty-handler':
+  ensure  => 'present',
+  version => '1.2.0',
+}
+```
+
+Install latest version of a bonsai asset. Puppet will update the Bonsai asset if a new version is released.
+```puppet
+sensu_bonsai_asset { 'sensu/sensu-pagerduty-handler':
+  ensure  => 'present',
+  version => 'latest',
+}
+```
+
 ## Reference
 
 ### Facts
@@ -596,8 +655,6 @@ facter -p sensuctl
 The Sensu v2 support is designed so that all resources managed by `sensuctl` are defined on the `sensu-backend` host.
 This module does not support adding `sensuctl` resources on a host other than the `sensu-backend` host.
 
-The type `sensu_asset` does not at this time support `ensure => absent` due to a limitation with sensuctl, see [sensu-go#988](https://github.com/sensu/sensu-go/issues/988).
-
 The type `sensu_user` does not at this time support `ensure => absent` due to a limitation with sensuctl, see [sensu-go#2540](https://github.com/sensu/sensu-go/issues/2540).
 
 ### Notes regarding support