puppet-puppetversion

####Table of Contents

1. Overview
2. Module Description - What is the puppetversion module?
3. Setup - The basics of getting started with puppetversion
   • What puppetversion affects
   • Setup requirements
   • Beginning with puppetversion
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

##Overview

The puppetversion module for managing the upgrade/downgrade of puppet to a specified version

##Module Description

The purpose of this module is to manage puppet upgrades. This was created because performing upgrades on on some platforms and some older versions of puppet requires a little more effort than simply package { 'puppet': ensure => '3.4.3' }. This module intends to deal with all of those edge cases, making upgrades as simple as they should be.

##Setup

###What puppetversion affects

• The installation of puppet itself.
• Create a scheduled task (on Windows)

###Beginning with puppetversion

To upgrade to a new puppetversion

   class { 'puppetversion':
     version => '3.4.3'
   }

##Usage

###Classes and Defined Types

####Class: puppetversion The puppetversion module guides the upgrade of puppet.

Parameters within puppetversion: #####version The version that you want to upgrade to

#####proxy_address (Windows only) - The proxy address to use when downloading the msi

#####download_source (Windows only) - The source location where the msi can be found

#####time_delay (Windows only) - How many minutes in the future should we schedule the upgrade task for

#####ruby_augeas_version (Debian only) - The version of ruby-augeas to install from RubyGems.

##Reference

###Classes ####Public Classes

• puppetversion: Guides the upgrade of puppet from the current version to the specified new version

##Limitations

This module is tested on the following platforms:

• CentOS 5
• CentOS 6
• CentOS 7
• Ubuntu 12.04
• Ubuntu 14.04
• Windows 2008 R2
• Windows 2012 R2

It is tested with the OSS version of Puppet only.

##Development

###Contributing

Please read CONTRIBUTING.md for full details on contributing to this project.

#2016-03-21 - Release 1.1.0 ###Summary

Lots of small improvements

###Improvements

• ruby 2 support
• updated apt dependency to <3.0.0
• centos 7 support

##2014-10-10 - Release 1.0.0 ###Summary

Bumped to 1.0. Improving documentation and testing

###Bugfixes

• Fixes bug with windows scheduled task not cleaning up properly

##2014-05-30 - Release 0.1.3 ###Summary

This release was mostly about testing. Adding some beaker tests to catch edge cases on windows.

####Features

• adding windows acceptance tests

####Bugfixes

• fixing issue with windows scheduled task not working

##2014-04-07 - Release 0.1.2 ###Summary

Minor bugfix release for support less strict version of inifile

####Bugfixes

• less strict on version on inifile dependency

##2014-03-28 - Release 0.1.1 ###Summary

Minor bugfix release.

####Bugfixes

• fixed some misleading documentation

2014-03-28 Release 0.1.0 ###Summary

Initial release. Support upgrading both windows and linux agents