Skip to content

Latest commit

 

History

History
141 lines (91 loc) · 3.63 KB

README.md

File metadata and controls

141 lines (91 loc) · 3.63 KB
Raw

vagrant-puppet-install

Gem Version Build Status

A Vagrant plugin that ensures the desired version of Puppet is installed via the Puppet Labs package repo. This proves very useful when using Vagrant with provisioner-less baseboxes OR cloud images.

This plugin has been verified to work with the following Vagrant providers:

It may work with other Vagrant providers but is not guaranteed to!

Installation

Ensure you have downloaded and installed Vagrant 1.1.x from the Vagrant downloads page.

Installation is performed in the prescribed manner for Vagrant 1.1 plugins.

$ vagrant plugin install vagrant-puppet-install

Usage

The Puppet Install Vagrant plugin automatically hooks into the Vagrant provisioning middleware. You specify the version of the puppet-common package you want installed using the puppet_install.puppet_version config key. The version string should be a valid Puppet release (ie. 2.7.11, 3.7.4, etc.).

The Puppet version is validated against the RubyGems API. So as long as the version you give is listed there, it will allow you to install.

You may wish to disable this validation. This could be useful if you've got limited bandwidth on a bad internet connection or you're on a proxy, or your specifying a version that won't match against the RubyGems API (such as a custom patched version of Puppet).

If you wish to disable this validation you can disable it like so:

Vagrant.configure("2") do |config|

  config.puppet_install.validate_version = false

  ...

end

Install the latest version of Puppet:

Vagrant.configure("2") do |config|

  config.puppet_install.puppet_version = :latest

  ...

end

Install a specific version of Puppet:

Vagrant.configure("2") do |config|

  config.puppet_install.puppet_version = "2.7.11"

  ...

end

Specify a custom install script:

Vagrant.configure("2") do |config|

  config.puppet_install.install_url = 'http://acme.com/install.sh'
  # config.puppet_install.install_url = 'http://acme.com/install.msi'
  # config.puppet_install.install_url = '/some/path/on/the/host'

  ...

end

Tests

Unit

The unit tests can be run with:

bundle exec rake
#or
bundle exec rake test:unit

The test are also executed by Travis CI every time code is pushed to GitHub.

Acceptance

The acceptance tests will be run against the Vagrant providers mentioned above.

The acceptance tests can be run with:

# to run them all
rake test:acceptance
# or specify a provider
rake test:acceptance['virtualbox']

And as expected, all acceptance tests only uses provisioner-less baseboxes and cloud images!

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Authors

Patrick Connolly Martin Lazarov Peter Souter

Adapted from original code by

Seth Chisamore