README.md in vagrant-ovirt3-1.2.0 vs README.md in vagrant-ovirt3-1.3.0

- old
+ new

@@ -1,6 +1,8 @@ # Vagrant oVirt/RHEV v3 Provider +[![Gem Version](https://badge.fury.io/rb/vagrant-ovirt3.svg)](http://badge.fury.io/rb/vagrant-ovirt3) +[![vagrant-ovirt3 API Documentation](https://www.omniref.com/ruby/gems/vagrant-ovirt3.png)](https://www.omniref.com/ruby/gems/vagrant-ovirt3) This is a [Vagrant](http://www.vagrantup.com) 1.1+ plugin that adds an [oVirt v3](http://ovirt.org) and [rhev v3](http://www.redhat.com/products/virtualization/) provider to Vagrant, allowing Vagrant to control and provision machines in oVirt and RHEV. @@ -24,14 +26,14 @@ ```ruby Vagrant.configure('2') do |config| config.vm.box = 'ovirt' config.vm.box_url = 'https://github.com/myoung34/vagrant-ovirt3/blob/master/example_box/dummy.box?raw=true' - config.vm.network :private_network, + config.vm.network :private_network, :ip => '192.168.56.100', :nictype => 'virtio', :netmask => '255.255.255.0', #normal network configuration :ovirt__ip => '10.101.55.72', :ovirt__network_name => 'ovirtmgmt', :ovirt__gateway => '10.101.55.1' # oVirt specific information, overwrites previous on oVirt provider - + config.vm.provider :ovirt3 do |ovirt| ovirt.template = 'template' ovirt.cpus = 1 ovirt.memory = 1024 ovirt.console = 'vnc' #could also be 'spice' @@ -62,14 +64,21 @@ ### Domain Specific Options * `memory` - Amount of memory in MBytes. Defaults to 512 if not set. * `cpus` - Number of virtual cpus. Defaults to 1 if not set. * `template` - Name of template from which new VM should be created. +* `template_version` - If a template has sub-versions, specify a sub-version + number or name. * `console` - Console type to use. Can be 'vnc' or 'spice'. Default is 'spice' * `disk_size` - If set, the first volume of the VM will automatically be resized to the specified value. disk_size is in GB +* `user_data` - If given, user data is made available to the VM via a virtual + floppy disk. This data is used to configure VMs via cloud-init. The value for + `user_data` should generally be a string in [cloud-config format][]. +[cloud-config format]: https://cloudinit.readthedocs.org/en/latest/topics/examples.html + Specific domain settings can be set for each domain separately in multi-VM environment. Example below shows a part of Vagrantfile, where specific options are set for dbserver domain. ```ruby @@ -93,18 +102,18 @@ ```ruby Vagrant.configure('2') do |config| config.vm.box = 'mybox' - config.vm.network :private_network, + config.vm.network :private_network, :ip => '192.168.56.100', :nictype => 'virtio', :netmask => '255.255.255.0' #normal network configuration :ovirt__ip => '10.101.55.72', :ovirt__network_name => 'ovirtmgmt', :ovirt__gateway => '10.101.55.1', # oVirt specific information, overwrites previous on oVirt provider - + config.vm.provider :virtualbox do |vb| vb.customize [ # Key Value - 'modifyvm', :id, + 'modifyvm', :id, '--cpuexecutioncap', '90', '--memory', '1376', '--nictype2', 'virtio', ] end @@ -125,18 +134,28 @@ shell.inline = 'uname -a > /var/log/something.log 2>&1' end config.vm.provision :puppet do |puppet| puppet.options = [ - "--environment development", - '--hiera_config=/etc/puppet/hiera/hiera.yaml', + "--environment development", + '--hiera_config=/etc/puppet/hiera/hiera.yaml', ] puppet.manifests_path = './manifests' puppet.manifest_file = 'default.pp' end ``` +### Parallel Support + +By default VMs will be created and provisioned in parallel. If this causes +resource issues or you want VMs to be created in series use --no-parallel + +``` +$ vagrant up +$ vagrant up --no-parallel +``` + ### How Project Is Created Vagrant goes through steps below when creating new project: 1. Connect to oVirt via REST API on every REST query. @@ -186,6 +205,5 @@ 1. Fork it 2. Create your feature branch (`git checkout -b my-new-feature`) 3. Commit your changes (`git commit -am 'Add some feature'`) 4. Push to the branch (`git push origin my-new-feature`) 5. Create new Pull Request -