Skip to content

chef/kitchen-vcenter

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.