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
-