0.05
The project is in a healthy, maintained state
Test Kitchen driver for VMware vCenter using SDK
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Runtime

>= 2.0.0, < 3.0
>= 1.11, < 4.0
>= 1.16, < 4
 Project Readme

kitchen-vcenter

Gem Version Build status

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.

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

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:

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

License

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.