add url deploy feature (#1803)

add url deploy feature

SUMMARY
Add to vmware_deploy_ovf 'url' parameter (mutually exclusive with 'ovf' parameter) for remote deploy from http server.
ISSUE TYPE

Feature Pull Request

COMPONENT NAME
vmware_deploy_ovf

Reviewed-by: Mario Lenz <m@riolenz.de>
Reviewed-by: Александр <ihumster@ihumster.ru>

Author: ihumster

.gitignore

@@ -389,3 +389,6 @@ changelogs/.plugin-cache.yaml
 
 # End of https://www.gitignore.io/api/git,linux,pydev,python,windows,pycharm+all,jupyternotebook,vim,webstorm,emacs,dotenv
 tests/integration/cloud-config-vcenter.ini
+
+# Visual Studio Code
+.vscode

README.md

@@ -111,7 +111,7 @@ Name | Description
 [community.vmware.vmware_datastore_cluster_manager](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_datastore_cluster_manager_module.rst)|Manage VMware vSphere datastore cluster's members
 [community.vmware.vmware_datastore_info](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_datastore_info_module.rst)|Gather info about datastores available in given vCenter
 [community.vmware.vmware_datastore_maintenancemode](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_datastore_maintenancemode_module.rst)|Place a datastore into maintenance mode
-[community.vmware.vmware_deploy_ovf](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_deploy_ovf_module.rst)|Deploys a VMware virtual machine from an OVF or OVA file
+[community.vmware.vmware_deploy_ovf](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_deploy_ovf_module.rst)|Deploys a VMware virtual machine from an OVF or OVA file, placed on file system or HTTP server
 [community.vmware.vmware_drs_group](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_drs_group_module.rst)|Creates vm/host group in a given cluster.
 [community.vmware.vmware_drs_group_info](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_drs_group_info_module.rst)|Gathers info about DRS VM/Host groups on the given cluster
 [community.vmware.vmware_drs_group_manager](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_drs_group_manager_module.rst)|Manage VMs and Hosts in DRS group.

docs/community.vmware.vmware_deploy_ovf_module.rst

@@ -5,7 +5,7 @@
 community.vmware.vmware_deploy_ovf
 **********************************
 
-**Deploys a VMware virtual machine from an OVF or OVA file**
+**Deploys a VMware virtual machine from an OVF or OVA file, placed on file system or HTTP server**
 
 
 
@@ -16,7 +16,7 @@ community.vmware.vmware_deploy_ovf
 
 Synopsis
 --------
-- This module can be used to deploy a VMware VM from an OVF or OVA file
+- This module can be used to deploy a VMware VM from an OVF or OVA file, placed on file system or HTTP server
 
 
 
@@ -288,6 +288,8 @@ Parameters
                 </td>
                 <td>
                         <div>Path to OVF or OVA file to deploy.</div>
+                        <div>This is a required parameter, if <code>ovf</code> is not set and <code>url</code> parameter must be set.</div>
+                        <div><code>ovf</code> and <code>url</code> are mutually exclusive parameters.</div>
                         <div style="font-size: small; color: darkgreen"><br/>aliases: ova</div>
                 </td>
             </tr>
@@ -411,6 +413,23 @@ Parameters
                         <div>Resource Pool to deploy to.</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>url</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                </td>
+                <td>
+                </td>
+                <td>
+                        <div>URL for OVA file to deploy.</div>
+                        <div>This is a required parameter, if <code>url</code> is not set and <code>ovf</code> parameter must be set.</div>
+                        <div><code>url</code> and <code>ovf</code> are mutually exclusive parameters.</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="1">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -498,6 +517,7 @@ Notes
 -----
 
 .. note::
+   - For use https as source need enable in firewall incoming 443 port
    - All modules requires API write access and hence is not supported on a free ESXi license.
 
 
@@ -539,6 +559,14 @@ Examples
         ovf: /path/to/ubuntu-16.04-amd64.ovf
       delegate_to: localhost
 
+    - community.vmware.vmware_deploy_ovf:
+        hostname: '{{ vcenter_hostname }}'
+        username: '{{ vcenter_username }}'
+        password: '{{ vcenter_password }}'
+        url: https://cloud-images.ubuntu.com/releases/xenial/release/ubuntu-16.04-server-cloudimg-amd64.ova
+        wait_for_ip_address: true
+      delegate_to: localhost
+
 
 
 Return Values
@@ -581,4 +609,5 @@ Status
 Authors
 ~~~~~~~
 
-- Matt Martz (@sivel)
+- Alexander Nikitin (@ihumster)
+- Matt Martz <matt@sivel.net>