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
andbundle 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)
Copyright:: Copyright (c) 2017-2022 Chef Software, Inc.
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.