Documentation of winrm options

[martinmosegaard]

From the README, it looks like the winrm options should be set under customization_spec.
But from driver.rb in the source code, it seems to be read from [:bootstrap_options][:ssh].

Maybe the bootstrap ssh options could be documented together in their own section?

[michaeltlombardi]

While not very intuitive, the README does say that the ssh options also apply to WinRM:

• [:ssh][:user] user to use for ssh/winrm (defaults to root on linux/administrator on windows)
• [:ssh][:password] - password to use for ssh/winrm
• [:ssh][:paranoid] - specifies the strictness of the host key verification checking
• [:ssh][:port] port to use for ssh/winrm (defaults to 22 for ssh or 5985 for winrm)

Whereas the machine options in customization_spec are for options not covered in the above - things like SSL, timeout, etc.

[martinmosegaard]

I may be wrong, but if we look at the code here:
https://github.com/CenturyLinkCloud/chef-provisioning-vsphere/blob/master/lib/chef/provisioning/vsphere_driver/driver.rb

• Then, in line 660, create_winrm_transport, options includes winrm_transport and winrm_opts.
• create_winrm_transport is called from transport_for, above.
• transport_for is called with ssh options, not customization_spec, as in:

transport_for(
        machine_spec,
        machine_options[:bootstrap_options][:ssh]

I did some brief testing and it seemed I had to put the winrm stuff under ssh, not customization_spec.