vagrant-vmware-esxi 1.5.1 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +98 -145
- data/example_box/Vagrantfile +61 -55
- data/example_box/Vagrantfile-multimachine +5 -5
- data/lib/vagrant-vmware-esxi/action/boot.rb +1 -1
- data/lib/vagrant-vmware-esxi/action/createvm.rb +157 -161
- data/lib/vagrant-vmware-esxi/action/destroy.rb +1 -1
- data/lib/vagrant-vmware-esxi/action/esxi_password.rb +6 -6
- data/lib/vagrant-vmware-esxi/action/halt.rb +1 -1
- data/lib/vagrant-vmware-esxi/action/package.rb +3 -3
- data/lib/vagrant-vmware-esxi/action/read_ssh_info.rb +1 -1
- data/lib/vagrant-vmware-esxi/action/read_state.rb +1 -1
- data/lib/vagrant-vmware-esxi/action/resume.rb +1 -1
- data/lib/vagrant-vmware-esxi/action/set_network_ip.rb +5 -5
- data/lib/vagrant-vmware-esxi/action/snapshot_delete.rb +1 -1
- data/lib/vagrant-vmware-esxi/action/snapshot_info.rb +1 -1
- data/lib/vagrant-vmware-esxi/action/snapshot_list.rb +1 -1
- data/lib/vagrant-vmware-esxi/action/snapshot_restore.rb +1 -1
- data/lib/vagrant-vmware-esxi/action/snapshot_save.rb +28 -3
- data/lib/vagrant-vmware-esxi/action/suspend.rb +1 -1
- data/lib/vagrant-vmware-esxi/config.rb +186 -57
- data/lib/vagrant-vmware-esxi/version.rb +1 -1
- data/vagrant-vmware-esxi.gemspec +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: d5daa11a6e5b364f38c0676918faa0b733e8dc3c
|
4
|
+
data.tar.gz: dd212a04fa4836c7f187c336a9783f5975272eb1
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: a515dc8d554fc85b8023f0414014ff966c41063adfa6ed9a9bdcae9dc14d2a289afe242ede60e89d6455afffc121ba9b851a7be7be89b6a907c6565bc0005e4b
|
7
|
+
data.tar.gz: cd4f60c7d90e86e23b2ecfb210c0e7b1ece805e6072f647e364127a40af3db9be7e19d18d86b9da922698be4396391e2211d5db8fce96f9a644f177830de6c48
|
data/README.md
CHANGED
@@ -39,7 +39,7 @@ Requirements
|
|
39
39
|
3. You MUST enable ssh access on your ESXi hypervisor.
|
40
40
|
* Google 'How to enable ssh access on esxi'
|
41
41
|
4. The boxes must have open-vm-tools or vmware-tools installed to properly transition to the 'running' state.
|
42
|
-
5.
|
42
|
+
5. In general, you should know how to use vagrant and esxi...
|
43
43
|
|
44
44
|
Why this plugin?
|
45
45
|
----------------
|
@@ -60,6 +60,9 @@ How to use and configure a Vagrantfile
|
|
60
60
|
1. `vagrant init`
|
61
61
|
1. `vi Vagrantfile` # See below to setup access your ESXi host and to set some preferences.
|
62
62
|
```ruby
|
63
|
+
#
|
64
|
+
# Fully documented Vagrantfile available
|
65
|
+
# in the wiki: https://github.com/josenk/vagrant-vmware-esxi/wiki
|
63
66
|
Vagrant.configure('2') do |config|
|
64
67
|
|
65
68
|
# Box, Select any box created for VMware that is compatible with
|
@@ -85,19 +88,17 @@ Vagrant.configure('2') do |config|
|
|
85
88
|
#config.vm.box = 'puphpet/debian75-x64'
|
86
89
|
|
87
90
|
|
88
|
-
# Use rsync
|
91
|
+
# Use rsync and NFS synced folders. (or disable them)
|
89
92
|
config.vm.synced_folder('.', '/vagrant', type: 'rsync')
|
90
93
|
config.vm.synced_folder('.', '/vagrant', type: 'nfs', disabled: true)
|
91
94
|
|
92
95
|
# Vagrant can set a static IP for the additional network interfaces. Use
|
93
96
|
# public_network or private_network to manually set a static IP and
|
94
97
|
# netmask. ESXi doesn't use the concept of public or private networks so
|
95
|
-
# both are valid here.
|
96
|
-
#
|
97
|
-
#
|
98
|
-
#
|
99
|
-
# new esxi.virtual_network for each static IP you configure.
|
100
|
-
# *** Invalid settings could cause 'vagrant up' to fail ***
|
98
|
+
# both are valid here. The primary network interface is considered the
|
99
|
+
# "vagrant management" interface and cannot be changed,
|
100
|
+
# so you can specify 3 entries here!
|
101
|
+
# *** Invalid settings could cause 'vagrant up' to fail ***
|
101
102
|
#config.vm.network 'private_network', ip: '192.168.10.170', netmask: '255.255.255.0'
|
102
103
|
#config.vm.network 'private_network', ip: '192.168.11.170'
|
103
104
|
#config.vm.network 'public_network', ip: '192.168.12.170'
|
@@ -108,170 +109,91 @@ Vagrant.configure('2') do |config|
|
|
108
109
|
config.vm.provider :vmware_esxi do |esxi|
|
109
110
|
|
110
111
|
# REQUIRED! ESXi hostname/IP
|
111
|
-
# You MUST specify a esxi_hostname or IP, uless you
|
112
|
-
# were lucky enough to name your esxi host 'esxi'. :-)
|
113
112
|
esxi.esxi_hostname = 'esxi'
|
114
113
|
|
115
114
|
# ESXi username
|
116
|
-
# Default is 'root'.
|
117
115
|
esxi.esxi_username = 'root'
|
118
116
|
|
119
|
-
#
|
120
|
-
# IMPORTANT! ESXi password.
|
121
|
-
# *** NOTES about esxi_passwords & ssh keys!! ***
|
122
|
-
#
|
117
|
+
# IMPORTANT! Set ESXi password.
|
123
118
|
# 1) 'prompt:'
|
124
|
-
# This will prompt you for the esxi password each time you
|
125
|
-
# run a vagrant command. This is the default.
|
126
|
-
#
|
127
119
|
# 2) 'file:' or 'file:my_secret_file'
|
128
|
-
# This will read a plain text file containing the esxi
|
129
|
-
# password. The default filename is ~/.esxi_password, or
|
130
|
-
# you can specify any filename after the colon ':'.
|
131
|
-
#
|
132
120
|
# 3) 'env:' or 'env:my_secret_env_var'
|
133
|
-
#
|
134
|
-
#
|
135
|
-
# specify any environment variable after the colon ':'.
|
136
|
-
#
|
137
|
-
# $ export esxi_password='my_secret_password'
|
138
|
-
#
|
139
|
-
# 4) 'key:' or key:~/.ssh/some_ssh_private_key'
|
140
|
-
# Use ssh keys. The default is to use the system private keys,
|
141
|
-
# or you specify a custom private key after the colon ':'.
|
142
|
-
#
|
143
|
-
# To test connectivity. From your command line, you should be able to
|
144
|
-
# run following command without an error and get an esxi prompt.
|
145
|
-
#
|
146
|
-
# $ ssh root@ESXi_IP_ADDRESS
|
147
|
-
#
|
148
|
-
# The ssh connections to esxi will try the ssh private
|
149
|
-
# keys. However the ovftool does NOT! To make
|
150
|
-
# vagrant fully password-less, you will need to use other
|
151
|
-
# options. (set the password, use 'env:' or 'file:')
|
152
|
-
#
|
153
|
-
# 5) esxi.esxi_password = 'my_esxi_password'
|
154
|
-
# Enter your esxi passowrd in clear text here... This is the
|
155
|
-
# least secure method because you may share this Vagrant file without
|
156
|
-
# realizing the password is in clear text.
|
121
|
+
# 4) 'key:' or key:~/.ssh/some_ssh_private_key'
|
122
|
+
# 5) or esxi.esxi_password = 'my_esxi_password'
|
157
123
|
#
|
158
|
-
# IMPORTANT! Set the ESXi password or authentication method..
|
159
124
|
esxi.esxi_password = 'prompt:'
|
160
125
|
|
161
126
|
# SSH port.
|
162
|
-
# Default port 22.
|
163
127
|
#esxi.esxi_hostport = 22
|
164
128
|
|
165
129
|
# HIGHLY RECOMMENDED! Virtual Network
|
166
|
-
# You should specify a Virtual Network
|
167
|
-
#
|
168
|
-
#
|
169
|
-
#
|
170
|
-
# using an array format. NOTE: This does not configure IP addresses.
|
171
|
-
# For most OS's DHCP is the default, so you will need a DHCP server for
|
172
|
-
# each ESXi virtual network. To set a static IP address on the
|
173
|
-
# second, third or 4th interface, see above 'config.vm.network'.
|
174
|
-
#
|
175
|
-
#esxi.virtual_network = ['vmnet1','vmnet2','vmnet3','vmnet4']
|
176
|
-
|
177
|
-
# OPTIONAL & RISKY. Specify up to 4 MAC addresses
|
178
|
-
# The default is for ovftool to automatically generate a MAC address.
|
179
|
-
# You can specify an array of MAC addresses using upper or lower case,
|
180
|
-
# separated by colons ':'. I highly recommend using vmware's OUI
|
181
|
-
# of '00:50:56' or '00:0c:29'. I consider this option a risk
|
182
|
-
# because you may reuse a Vagrantfile without realizing you are
|
183
|
-
# duplicating the MAC address.
|
184
|
-
# *** Invalid settings could cause 'vagrant up' to fail ***
|
185
|
-
#esxi.mac_address = ['00:50:56:aa:bb:cc', '00:50:56:01:01:01','00:50:56:02:02:02','00:50:56:BE:AF:01' ]
|
186
|
-
|
187
|
-
# OPTIONAL & RISKY. Specify a nic_type
|
188
|
-
# The default is to have the virtual nic hw type automatically
|
189
|
-
# determined by the ovftool. However, you can override it by specifying
|
190
|
-
# it here. This is a global setting. (all 4 virtual networks will be set)
|
191
|
-
# The validated list of nic_types are 'e1000', 'e1000e', 'vmxnet',
|
192
|
-
# 'vmxnet2', 'vmxnet3', 'Vlance', and 'Flexible'. I consider this
|
193
|
-
# risky because I don't validate if the specified nic_type is
|
194
|
-
# compatible with your OS version.
|
195
|
-
# *** Invalid settings could cause 'vagrant up' to fail ***
|
196
|
-
#esxi.nic_type = 'e1000'
|
130
|
+
# You should specify a Virtual Network! If it's not specified, the
|
131
|
+
# default is to use the first found. You can specify up to 4 virtual
|
132
|
+
# networks using an array format.
|
133
|
+
#esxi.esxi_virtual_network = ['vmnet1','vmnet2','vmnet3','vmnet4']
|
197
134
|
|
198
135
|
# OPTIONAL. Specify a Disk Store
|
199
|
-
#
|
200
|
-
#esxi.vm_disk_store = 'DS_001'
|
136
|
+
#esxi.esxi_disk_store = 'DS_001'
|
201
137
|
|
202
|
-
# OPTIONAL.
|
203
|
-
#
|
204
|
-
#
|
205
|
-
#esxo.vm_disk_type = 'thick'
|
138
|
+
# OPTIONAL. Resource Pool
|
139
|
+
# Vagrant will NOT create a Resource pool it for you.
|
140
|
+
#esxi.esxi_resource_pool = '/Vagrant'
|
206
141
|
|
207
142
|
# OPTIONAL. Guest VM name to use.
|
208
|
-
# The Default will be automatically generated.
|
209
|
-
#
|
210
|
-
|
211
|
-
#
|
143
|
+
# The Default will be automatically generated.
|
144
|
+
#esxi.guest_name = 'Custom-Guest-VM_Name'
|
145
|
+
|
146
|
+
# OPTIONAL. When automatically naming VMs, use this prifix.
|
147
|
+
#esxi.guest_name_prefix = 'V-'
|
148
|
+
|
212
149
|
|
213
|
-
# OPTIONAL.
|
214
|
-
#
|
215
|
-
#esxi.vmname_prefix = 'V-'
|
150
|
+
# OPTIONAL. Set the guest username login. The default is 'vagrant'.
|
151
|
+
#esxi.guest_username = 'vagrant'
|
216
152
|
|
217
153
|
# OPTIONAL. Memory size override
|
218
|
-
#
|
219
|
-
# vmx file, however you can specify a new value here.
|
220
|
-
#esxi.memsize = '2048'
|
154
|
+
#esxi.guest_memsize = '2048'
|
221
155
|
|
222
156
|
# OPTIONAL. Virtual CPUs override
|
223
|
-
#
|
224
|
-
# in the vmx file, however you can specify a new value here.
|
225
|
-
#esxi.numvcpus = '2'
|
157
|
+
#esxi.guest_numvcpus = '2'
|
226
158
|
|
227
|
-
# OPTIONAL.
|
228
|
-
#
|
229
|
-
# specify
|
230
|
-
#
|
231
|
-
#
|
232
|
-
|
233
|
-
#
|
234
|
-
#
|
235
|
-
|
236
|
-
#
|
237
|
-
|
238
|
-
#
|
239
|
-
#
|
240
|
-
#
|
241
|
-
#
|
242
|
-
|
243
|
-
|
244
|
-
#
|
245
|
-
#
|
246
|
-
|
247
|
-
#
|
159
|
+
# OPTIONAL & RISKY. Specify up to 4 MAC addresses
|
160
|
+
# The default is ovftool to automatically generate a MAC address.
|
161
|
+
# You can specify an array of MAC addresses using upper or lower case,
|
162
|
+
# separated by colons ':'.
|
163
|
+
#esxi.guest_mac_address = ['00:50:56:aa:bb:cc', '00:50:56:01:01:01','00:50:56:02:02:02','00:50:56:BE:AF:01' ]
|
164
|
+
|
165
|
+
# OPTIONAL & RISKY. Specify a guest_nic_type
|
166
|
+
# The validated list of guest_nic_types are 'e1000', 'e1000e', 'vmxnet',
|
167
|
+
# 'vmxnet2', 'vmxnet3', 'Vlance', and 'Flexible'.
|
168
|
+
#esxi.guest_nic_type = 'e1000'
|
169
|
+
|
170
|
+
# OPTIONAL. Specify a disk type.
|
171
|
+
# If unspecified, it will be set to 'thin'. Otherwise, you can set to
|
172
|
+
# 'thin', 'thick', or 'eagerzeroedthick'
|
173
|
+
#esxi.guest_disk_type = 'thick'
|
174
|
+
|
175
|
+
# OPTIONAL. specify snapshot options.
|
176
|
+
#esxi.guest_snapshot_includememory = 'true'
|
177
|
+
#esxi.guest_snapshot_quiesced = 'true'
|
178
|
+
|
179
|
+
# RISKY. guest_guestos
|
180
|
+
# https://github.com/josenk/vagrant-vmware-esxi/ESXi_guest_guestos_types.md
|
181
|
+
#esxi.guest_guestos = 'centos-64'
|
182
|
+
|
183
|
+
# OPTIONAL. guest_virtualhw_version
|
248
184
|
# ESXi 6.5 supports these versions. 4,7,8,9,10,11,12 & 13.
|
249
|
-
#esxi.
|
250
|
-
|
251
|
-
# RISKY.
|
252
|
-
#
|
253
|
-
|
254
|
-
#
|
255
|
-
#
|
256
|
-
# CPU settings, etc...).
|
257
|
-
# ex vhv.enable = 'TRUE' will be appended, floppy0.presend = 'TRUE' will be modified
|
258
|
-
#esxi.custom_vmx_settings = [['vhv.enable','TRUE'], ['floppy0.present','TRUE']]
|
259
|
-
|
260
|
-
# OPTIONAL. lax
|
261
|
-
# If unspecified, the ovftool option --lax is disabled. If you are
|
262
|
-
# importing ovf boxes that generate errors, you may want to enable lax
|
263
|
-
# to convert the errors to warning. (then the import could succeed)
|
264
|
-
#esxi.lax = 'true'
|
185
|
+
#esxi.guest_virtualhw_version = '9'
|
186
|
+
|
187
|
+
# RISKY. guest_custom_vmx_settings
|
188
|
+
#esxi.guest_custom_vmx_settings = [['vhv.enable','TRUE'], ['floppy0.present','TRUE']]
|
189
|
+
|
190
|
+
# OPTIONAL. local_lax
|
191
|
+
#esxi.local_lax = 'true'
|
265
192
|
|
266
193
|
# DANGEROUS! Allow Overwrite
|
267
194
|
# If unspecified, the default is to produce an error if overwriting
|
268
195
|
# vm's and packages.
|
269
|
-
#
|
270
|
-
# when you run vagrant up. ie, if the vmname already exists,
|
271
|
-
# it will be destroyed, then over written... This is helpful
|
272
|
-
# if you have a VM that became an orphan (vagrant lost association).
|
273
|
-
# This will also overwrite your box when using vagrant package.
|
274
|
-
#esxi.allow_overwrite = 'True'
|
196
|
+
#esxi.local_allow_overwrite = 'True'
|
275
197
|
|
276
198
|
# Plugin debug output.
|
277
199
|
# Send bug reports with debug output...
|
@@ -281,6 +203,28 @@ Vagrant.configure('2') do |config|
|
|
281
203
|
end
|
282
204
|
```
|
283
205
|
|
206
|
+
Upgrading from vagrant-vmware-esxi 1.x.x
|
207
|
+
----------------------------------------
|
208
|
+
The following Vagrantfile parameters have been renamed for clarity. The plugin still recognizes these legacy parameters, however it's recommended to migrate to the 2.x parameters.
|
209
|
+
* esxi_private_keys --> esxi_password = "key:"
|
210
|
+
* vm_disk_store --> esxi_disk_store
|
211
|
+
* virtual_network --> esxi_virtual_network
|
212
|
+
* resource_pool --> esxi_resource_pool
|
213
|
+
* vmname --> guest_name
|
214
|
+
* vmname_prefix --> guest_name_prefix
|
215
|
+
* ssh_username --> guest_username
|
216
|
+
* memsize --> guest_memsize
|
217
|
+
* numvcpus --> guest_numvcpus
|
218
|
+
* vm_disk_type --> guest_disk_type
|
219
|
+
* nic_type --> guest_nic_type
|
220
|
+
* mac_address --> guest_mac_address
|
221
|
+
* guestos --> guest_guestos
|
222
|
+
* virtualhw_version --> guest_virtualhw_version
|
223
|
+
* custom_vmx_settings --> guest_custom_vmx_settings
|
224
|
+
* lax --> local_lax
|
225
|
+
* allow_overwrite --> local_allow_overwrite
|
226
|
+
|
227
|
+
|
284
228
|
Basic usage
|
285
229
|
-----------
|
286
230
|
1. `vagrant up --provider=vmware_esxi`
|
@@ -301,25 +245,34 @@ Basic usage
|
|
301
245
|
Known issues with vmware_esxi
|
302
246
|
-----------------------------
|
303
247
|
* The boxes must have open-vm-tools or vmware-tools installed to properly transition to the 'running' state.
|
304
|
-
* Invalid settings (bad IP address, netmask, MAC address,
|
305
|
-
* Cleanup doesn't always destroy a VM that has been partially built. Use the
|
248
|
+
* Invalid settings (bad IP address, netmask, MAC address, guest_custom_vmx_settings) could cause 'vagrant up' to fail. Review your ESXi logs to help debug why it failed.
|
249
|
+
* Cleanup doesn't always destroy a VM that has been partially built. Use the local_allow_overwrite = 'True' option if you need to force a rebuild, or delete the vm using the VSphere client.
|
306
250
|
* ovftool installer for windows doesn't put ovftool.exe in your path. You can manually set your path, or install ovftool in the \HashiCorp\Vagrant\bin directory.
|
307
251
|
* In general I find NFS synced folders a little 'flaky'...
|
308
252
|
|
309
253
|
|
310
254
|
Version History
|
311
255
|
---------------
|
256
|
+
* 2.0.1 Updated version:
|
257
|
+
Most Vagrantfile options have been renamed to be consistent and for clarity.
|
258
|
+
vagrant up, more organized summary by esxi/guest options.
|
259
|
+
Lots of Code cleanup.
|
260
|
+
Add support for snapshot options (includeMemory & quiesced)
|
261
|
+
Snapshot save/push adds a description.
|
262
|
+
|
312
263
|
* 1.5.1 Fix:
|
313
264
|
Improve debug output.
|
314
265
|
Fix password encoding for @ character.
|
315
266
|
Automatically add a virtual network when configuring a public_network or private_network.
|
267
|
+
|
316
268
|
* 1.5.0 Add support for:
|
317
|
-
Specify
|
269
|
+
Specify guest_custom_vmx_settings (to add or modify vmx settings).
|
318
270
|
Specify Virtual HW version.
|
319
271
|
Allow $ in Password.
|
320
272
|
Disk types (thick, thin, eagerzeroedthick).
|
321
273
|
Specify a guestOS type (see list above).
|
322
|
-
|
274
|
+
Relocal_laxed ovftool setting (--local_lax), to allow importing strange ovf boxes.
|
275
|
+
|
323
276
|
* 1.4.0 Add support to set MAC and IP addresses for network interfaces.
|
324
277
|
* 1.3.2 Fix, Don't timeout ssh connection when ovftool takes a long time to upload image.
|
325
278
|
* 1.3.0 Add support to get esxi password from env, from a file or prompt.
|
data/example_box/Vagrantfile
CHANGED
@@ -111,106 +111,112 @@ Vagrant.configure('2') do |config|
|
|
111
111
|
# each network interface in your VM. For most OS's DHCP is the default,
|
112
112
|
# so, you will need a DHCP server for each virtual network. To set a
|
113
113
|
# static IP, see above 'config.vm.network'.
|
114
|
-
#esxi.
|
115
|
-
|
116
|
-
# OPTIONAL & RISKY. Specify up to 4 MAC addresses
|
117
|
-
# The default is ovftool to automatically generate a MAC address.
|
118
|
-
# You can specify an array of MAC addresses using upper or lower case,
|
119
|
-
# separated by colons ':'. I highly recommend using vmware's OUI
|
120
|
-
# of '00:50:56' or '00:0c:29'. I consider this option a risk
|
121
|
-
# because you may reuse a Vagrantfile without realizing you are
|
122
|
-
# duplicating the MAC address.
|
123
|
-
# *** Invalid settings could cause 'vagrant up' to fail ***
|
124
|
-
#esxi.mac_address = ['00:50:56:aa:bb:cc', '00:50:56:01:01:01','00:50:56:02:02:02','00:50:56:BE:AF:01' ]
|
125
|
-
|
126
|
-
# OPTIONAL & RISKY. Specify a nic_type
|
127
|
-
# The default is to have the virtual nic hw type automatically
|
128
|
-
# determined by the ovftool. However, you can override it by specifying
|
129
|
-
# it here. This is a global setting. (all 4 virtual networks will be set)
|
130
|
-
# The validated list of nic_types are 'e1000', 'e1000e', 'vmxnet',
|
131
|
-
# 'vmxnet2', 'vmxnet3', 'Vlance', and 'Flexible'. I consider this
|
132
|
-
# risky because I don't validate if the specified nic_type is
|
133
|
-
# compatible with your OS version.
|
134
|
-
# *** Invalid settings could cause 'vagrant up' to fail ***
|
135
|
-
#esxi.nic_type = 'e1000'
|
114
|
+
#esxi.esxi_virtual_network = ['vmnet1','vmnet2','vmnet3','vmnet4']
|
136
115
|
|
137
116
|
# OPTIONAL. Specify a Disk Store
|
138
117
|
# If it's not specified, the Default is to use the least used Disk Store.
|
139
|
-
#esxi.
|
118
|
+
#esxi.esxi_disk_store = 'DS_001'
|
140
119
|
|
141
|
-
# OPTIONAL.
|
142
|
-
# If unspecified,
|
143
|
-
#
|
144
|
-
#
|
120
|
+
# OPTIONAL. Resource Pool
|
121
|
+
# If unspecified, the default is to create VMs in the 'root'. You can
|
122
|
+
# specify a resource pool here to partition memory and cpu usage away
|
123
|
+
# from other systems on your esxi host. The resource pool must
|
124
|
+
# already exist and have the proper permissions set.
|
125
|
+
#
|
126
|
+
# Vagrant will NOT create a Resource pool it for you.
|
127
|
+
#esxi.esxi_resource_pool = '/Vagrant'
|
145
128
|
|
146
129
|
# OPTIONAL. Guest VM name to use.
|
147
130
|
# The Default will be automatically generated. It will be based on
|
148
|
-
# the
|
131
|
+
# the guest_name_prefix (see below), your hostname & username and path.
|
149
132
|
# Otherwise you can set a fixed guest VM name here.
|
150
|
-
#esxi.
|
133
|
+
#esxi.guest_name = 'Custom-Guest-VM_Name'
|
134
|
+
|
135
|
+
# OPTIONAL. When automatically naming VMs, use this prifix.
|
136
|
+
#esxi.guest_name_prefix = 'V-'
|
151
137
|
|
152
|
-
# OPTIONAL.
|
153
|
-
#
|
154
|
-
#esxi.vmname_prefix = 'V-'
|
138
|
+
# OPTIONAL. Set the guest username login. The default is 'vagrant'.
|
139
|
+
#esxi.guest_username = 'vagrant'
|
155
140
|
|
156
141
|
# OPTIONAL. Memory size override
|
157
142
|
# The default is to use the memory size specified in the
|
158
143
|
# vmx file, however you can specify a new value here.
|
159
|
-
#esxi.
|
144
|
+
#esxi.guest_memsize = '2048'
|
160
145
|
|
161
146
|
# OPTIONAL. Virtual CPUs override
|
162
147
|
# The default is to use the number of virtual cpus specified
|
163
148
|
# in the vmx file, however you can specify a new value here.
|
164
|
-
#esxi.
|
149
|
+
#esxi.guest_numvcpus = '2'
|
165
150
|
|
166
|
-
# OPTIONAL.
|
167
|
-
# If unspecified,
|
168
|
-
#
|
169
|
-
#
|
170
|
-
|
171
|
-
#
|
172
|
-
#
|
173
|
-
#
|
151
|
+
# OPTIONAL. Specify a disk type.
|
152
|
+
# If unspecified, it will be set to 'thin'. Otherwise, you can set to
|
153
|
+
# 'thin', 'thick', or 'eagerzeroedthick'
|
154
|
+
#esxi.guest_disk_type = 'thick'
|
155
|
+
|
156
|
+
# OPTIONAL & RISKY. Specify up to 4 MAC addresses
|
157
|
+
# The default is ovftool to automatically generate a MAC address.
|
158
|
+
# You can specify an array of MAC addresses using upper or lower case,
|
159
|
+
# separated by colons ':'. I highly recommend using vmware's OUI
|
160
|
+
# of '00:50:56' or '00:0c:29'. I consider this option a risk
|
161
|
+
# because you may reuse a Vagrantfile without realizing you are
|
162
|
+
# duplicating the MAC address.
|
163
|
+
# *** Invalid settings could cause 'vagrant up' to fail ***
|
164
|
+
#esxi.guest_mac_address = ['00:50:56:aa:bb:cc', '00:50:56:01:01:01','00:50:56:02:02:02','00:50:56:BE:AF:01' ]
|
165
|
+
|
166
|
+
# OPTIONAL & RISKY. Specify a guest_nic_type
|
167
|
+
# The default is to have the virtual nic hw type automatically
|
168
|
+
# determined by the ovftool. However, you can override it by specifying
|
169
|
+
# it here. This is a global setting. (all 4 virtual networks will be set)
|
170
|
+
# The validated list of guest_nic_types are 'e1000', 'e1000e', 'vmxnet',
|
171
|
+
# 'vmxnet2', 'vmxnet3', 'Vlance', and 'Flexible'. I consider this
|
172
|
+
# risky because I don't validate if the specified guest_nic_type is
|
173
|
+
# compatible with your OS version.
|
174
|
+
# *** Invalid setting could cause 'vagrant up' to fail ***
|
175
|
+
#esxi.guest_nic_type = 'e1000'
|
176
|
+
|
177
|
+
# OPTIONAL. specify snapshot options.
|
178
|
+
#esxi.guest_snapshot_includememory = 'true'
|
179
|
+
#esxi.guest_snapshot_quiesced = 'true'
|
174
180
|
|
175
|
-
# RISKY.
|
181
|
+
# RISKY. guest_guestos
|
176
182
|
# if unspecified, the default will be generated by the OVFTool. Most
|
177
183
|
# of the time, you don't need to change this unless ovftool doesn't get
|
178
|
-
# the correct information from the box. See my page on supported
|
184
|
+
# the correct information from the box. See my page on supported guest_guestos
|
179
185
|
# types for ESXI.
|
180
|
-
# https://github.com/josenk/vagrant-vmware-esxi/
|
181
|
-
#esxi.
|
186
|
+
# https://github.com/josenk/vagrant-vmware-esxi/ESXi_guest_guestos_types.md
|
187
|
+
#esxi.guest_guestos = 'centos-64'
|
182
188
|
|
183
|
-
# OPTIONAL.
|
189
|
+
# OPTIONAL. guest_virtualhw_version
|
184
190
|
# If unspecified, the default will be generated by the OVFTool. Most
|
185
191
|
# of the time, you don't need to change this unless you are using advanced
|
186
192
|
# custom vmx settings that require it.
|
187
193
|
# ESXi 6.5 supports these versions. 4,7,8,9,10,11,12 & 13.
|
188
|
-
#esxi.
|
194
|
+
#esxi.guest_virtualhw_version = '9'
|
189
195
|
|
190
|
-
# RISKY.
|
196
|
+
# RISKY. guest_custom_vmx_settings
|
191
197
|
# You can specify an array of custom vmx settings to add (or to override
|
192
198
|
# existing settings). **** I don't do any validation, so if you
|
193
199
|
# make any errors, it will not be caught *** This is the place you would
|
194
200
|
# add any special settings you need in your vmx. (Like adding a USB, DVD
|
195
201
|
# CPU settings, etc...).
|
196
202
|
# ex vhv.enable = 'TRUE' will be appended, floppy0.presend = 'TRUE' will be modified
|
197
|
-
#esxi.
|
203
|
+
#esxi.guest_custom_vmx_settings = [['vhv.enable','TRUE'], ['floppy0.present','TRUE']]
|
198
204
|
|
199
|
-
# OPTIONAL.
|
205
|
+
# OPTIONAL. local_lax
|
200
206
|
# If unspecified, the ovftool option --lax is disabled. If you are
|
201
|
-
# importing ovf boxes that generate errors, you may want to enable
|
207
|
+
# importing ovf boxes that generate errors, you may want to enable local_lax
|
202
208
|
# to convert the errors to warning. (then the import could succeed)
|
203
|
-
#esxi.
|
209
|
+
#esxi.local_lax = 'true'
|
204
210
|
|
205
211
|
# DANGEROUS! Allow Overwrite
|
206
212
|
# If unspecified, the default is to produce an error if overwriting
|
207
213
|
# vm's and packages.
|
208
214
|
# Set this to 'True' will overwrite existing VMs (with the same name)
|
209
|
-
# when you run vagrant up. ie, if the
|
215
|
+
# when you run vagrant up. ie, if the guest_name already exists,
|
210
216
|
# it will be destroyed, then over written... This is helpful
|
211
217
|
# if you have a VM that became an orphan (vagrant lost association).
|
212
218
|
# This will also overwrite your box when using vagrant package.
|
213
|
-
#esxi.
|
219
|
+
#esxi.local_allow_overwrite = 'True'
|
214
220
|
|
215
221
|
# Plugin debug output.
|
216
222
|
# Send bug reports with debug output...
|