mirror of
https://github.com/puppetlabs/beaker-vmpooler.git
synced 2026-01-25 18:48:41 -05:00
46 lines
1.7 KiB
Markdown
46 lines
1.7 KiB
Markdown
# beaker-vmpooler
|
|
|
|
Beaker library to use vmpooler hypervisor
|
|
|
|
# How to use this wizardry
|
|
|
|
This is a gem that allows you to use hosts with [vmpooler](vmpooler.md) hypervisor with [beaker](https://github.com/puppetlabs/beaker).
|
|
|
|
Beaker will automatically load the appropriate hypervisors for any given hosts file, so as long as your project dependencies are satisfied there's nothing else to do. No need to `require` this library in your tests.
|
|
|
|
## With Beaker 3.x
|
|
|
|
This library is included as a dependency of Beaker 3.x versions, so there's nothing to do.
|
|
|
|
## With Beaker 4.x
|
|
|
|
As of Beaker 4.0, all hypervisor and DSL extension libraries have been removed and are no longer dependencies. In order to use a specific hypervisor or DSL extension library in your project, you will need to include them alongside Beaker in your Gemfile or project.gemspec. E.g.
|
|
|
|
~~~ruby
|
|
# Gemfile
|
|
gem 'beaker', '~>4.0'
|
|
gem 'beaker-vmpooler'
|
|
# project.gemspec
|
|
s.add_runtime_dependency 'beaker', '~>4.0'
|
|
s.add_runtime_dependency 'beaker-vmpooler'
|
|
~~~
|
|
|
|
# Spec tests
|
|
|
|
Spec test live under the `spec` folder. There are the default rake task and therefore can run with a simple command:
|
|
```bash
|
|
bundle exec rake test:spec
|
|
```
|
|
|
|
# Acceptance tests
|
|
|
|
We run beaker's base acceptance tests with this library to see if the hypervisor is working with beaker. There is a simple rake task to invoke acceptance test for the library:
|
|
```bash
|
|
bundle exec rake test:acceptance
|
|
```
|
|
|
|
# Contributing
|
|
|
|
Please refer to puppetlabs/beaker's [contributing](https://github.com/puppetlabs/beaker/blob/master/CONTRIBUTING.md) guide.
|
|
|
|
If you are making changes in beaker-vmpooler and simultaneously in beaker, please *comment and link* your beaker fork repo and branch name in your PR of beaker-vmpooler for testing on CI.
|