Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/petems/vagrant-puppet-install
A Vagrant plugin that ensures the desired version of Puppet is installed via the Puppet Labs package repo.
https://github.com/petems/vagrant-puppet-install
Last synced: about 1 month ago
JSON representation
A Vagrant plugin that ensures the desired version of Puppet is installed via the Puppet Labs package repo.
- Host: GitHub
- URL: https://github.com/petems/vagrant-puppet-install
- Owner: petems
- License: apache-2.0
- Created: 2014-02-21T14:19:14.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2023-05-04T11:59:03.000Z (over 1 year ago)
- Last Synced: 2024-10-03T09:59:24.533Z (about 2 months ago)
- Language: Ruby
- Homepage:
- Size: 151 KB
- Stars: 69
- Watchers: 5
- Forks: 22
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# vagrant-puppet-install
[][gem]
[][travis]
[gem]: https://rubygems.org/gems/vagrant-puppet-install
[travis]: http://travis-ci.org/petems/vagrant-puppet-install
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](http://docs.vagrantup.com/v2/providers/index.html):
* VirtualBox (part of core)
* AWS (ships in [vagrant-aws](https://github.com/mitchellh/vagrant-aws) plugin)
* Rackspace (ships in [vagrant-rackspace](https://github.com/mitchellh/vagrant-rackspace) plugin)
* DigitalOcean (ships in [vagrant-digital_ocean](https://github.com/smdahlen/vagrant-digitalocean) plugin)
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](http://downloads.vagrantup.com/).
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](https://rubygems.org/gems/puppet/versions/), 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:
```ruby
Vagrant.configure("2") do |config|
config.puppet_install.validate_version = false
...
end
```
Install the latest version of Puppet:
```ruby
Vagrant.configure("2") do |config|
config.puppet_install.puppet_version = :latest
...
end
```
Install a specific version of Puppet:
```ruby
Vagrant.configure("2") do |config|
config.puppet_install.puppet_version = "2.7.11"
...
end
```
Specify a custom install script:
```ruby
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