A Vagrant provider for VMware vCenter®
Ruby
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Vagrant provider for VMware vCenter®

Join the chat at https://gitter.im/frapposelli/vagrant-vcenter

Version 0.3.3 has been released!

Please note that this software is still Alpha/Beta quality and is not recommended for production usage.

We have a wide array of boxes available at Vagrant Cloud you can use them directly or you can roll your own as you please, make sure to install VMware tools in it.

This plugin supports the universal vmware_ovf box format, that is 100% portable between vagrant-vcloud, vagrant-vcenter and vagrant-vcloudair, no more double boxes!.

Changes in version 0.3.3 include:

Changes

  • Configuration setting computer_name renamed to compute_name as this can be either a vSphere host or a Cluster name.

Fixes

  • Better error management
  • Fixed some commands in unwanted situations (SSH when machine suspended/off)
  • Refactored code to avoid code duplication

Install

Latest version can be easily installed by running the following command:

vagrant plugin install vagrant-vcenter

Vagrant will download all the required gems during the installation process.

If you already have the plugin installed you can use:

vagrant plugin upgrade vagrant-vcenter

To perform an upgrade to the latest version.

After the install has completed a vagrant up --provider=vcenter will trigger the newly installed provider.

Configuration

Here's a sample Multi-VM Vagrantfile:

ENV['VAGRANT_DEFAULT_PROVIDER'] = 'vcenter'

nodes = []

[*1..5].each do |n|
  nodes << { hostname: "centos#{n}",
             box: 'gosddc/centos65-x64',
             ip: "10.250.21.#{n}",
             mem: 1024 * n,
             cpu: n }
end

[*1..5].each do |n|
  nodes << { hostname: "precise#{n}",
             box: 'gosddc/precise32',
             ip: "10.250.22.#{n}",
             mem: 1024 * n,
             cpu: n }
end

Vagrant.configure('2') do |config|

  # Go through nodes and configure each of them.
  nodes.each do |node|

    config.vm.provider :vcenter do |vcenter|
      vcenter.hostname = 'my.vcenter.hostname'
      vcenter.username = 'myUsername'
      vcenter.password = 'myPassword'
      vcenter.folder_name = 'myFolderName'
      vcenter.datacenter_name = 'MyDatacenterName'
      vcenter.compute_name = 'MyHostOrCluster'
      vcenter.datastore_name = 'MyDatastore'
      vcenter.network_name = 'myNetworkName'
      vcenter.linked_clones = true
    end

    config.vm.define node[:hostname] do |node_config|
      node_config.vm.box = node[:box]
      node_config.vm.hostname = node[:hostname]

      # Let's configure the network for the VM, only the ip changes and is
      # coming from the nodes array
      node_config.vm.network :public_network,
                             ip: node[:ip],
                             netmask: '255.255.0.0',
                             gateway: '10.250.254.254',
                             dns_server_list: ['8.8.4.4', '8.8.8.8'],
                             dns_suffix_list: ['ad.lab.gosddc.com']

      # Let's override some provider settings for specific VMs
      node_config.vm.provider :vcenter do |override|
        # Override number of cpu and memory based on what's in the nodes array
        override.num_cpu = node[:cpu]
        override.memory = node[:mem]
        case node[:hostname]
        # Override the folder name based on the hostname of the VM
        when /centos/
          override.folder_name = 'Vagrant/centos'
        when /precise/
          override.folder_name = 'Vagrant/ubuntu/precise'
          override.enable_vm_customization = false
        end
      end
      node_config.nfs.functional = false
    end
  end
end

Contribute

What is still missing:

  • TEST SUITES! (working on that).
  • Speed, the code is definitely not optimized.
  • Thorough testing.
  • Error checking is absymal.
  • Some spaghetti code here and there.
  • Bugs, bugs and BUGS!.

If you're a developer and want to lend us a hand, send us PRs!