kitchen-vcenter

This is the official Test Kitchen plugin for VMware vCenter via the vCenter REST API. This plugin allows Test Kitchen the ability to create, bootstrap, and test VMs in VMware infrastructures.

Documentation: https://github.com/chef/kitchen-vcenter/blob/master/README.md
Source: https://github.com/chef/kitchen-vcenter/tree/master
Issues: https://github.com/chef/kitchen-vcenter/issues
Mailing list: https://discourse.chef.io/

Please refer to the CHANGELOG for version history and known issues.

Requirements

Ruby 2.6 or higher
VMware vCenter/vSphere 5.5 or higher
VMs or templates to clone, with open-vm-tools installed
DHCP server to assign IPs to kitchen instances

Installation

The kitchen-vcenter driver ships as part of Chef Workstation. The easiest way to use this driver is to Download Chef Workstation.

If you want to install the driver directly into a Ruby installation:

gem install kitchen-vcenter

If you're using Bundler, simply add it to your Gemfile:

gem "kitchen-vcenter"

... and then run bundle install.

Configuration

See the kitchen.ci vCenter Driver Page for documentation on configuring this driver.

Contributing

For information on contributing to this project see https://github.com/chef/chef/blob/master/CONTRIBUTING.md

Development

Report issues/questions/feature requests on GitHub Issues

Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every separate change you make. For example:

Fork the repo
Create your feature branch (git checkout -b my-new-feature)
Run the tests and chefstyle, bundle exec rake spec and bundle exec rake style
Commit your changes (git commit -am 'Added some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

License

Author:: Russell Seymour (rseymour@chef.io)
Author:: JJ Asghar (jj@chef.io)
Author:: Thomas Heinen (theinen@tecracer.de)
Author:: Michael Kennedy (michael_l_kennedy@me.com)

License:: Apache License, Version 2.0

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.