prepare 1.7.0 release (ansible-collections#634)

prepare 1.7.0 release Reviewed-by: https://github.com/apps/ansible-zuul
Anant99-sys · Feb 1, 2021 · e37ed74 · e37ed74
1 parent a606edd
commit e37ed74
Show file tree

Hide file tree

Showing 11 changed files with 220 additions and 23 deletions.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -5,6 +5,41 @@ community.vmware Release Notes
 .. contents:: Topics
 
 
+v1.7.0
+======
+
+Minor Changes
+-------------
+
+- vmware_cluster_info - added a parent datacenter name of Cluster to the return value (https://github.com/ansible-collections/community.vmware/pull/591).
+- vmware_content_deploy_ovf_template - consistent ``eagerZeroedThick`` value (https://github.com/ansible-collections/community.vmware/issues/618).
+- vmware_content_deploy_template - add datastore cluster parameter (https://github.com/ansible-collections/community.vmware/issues/397).
+- vmware_content_deploy_template - make resource pool, host, cluster, datastore optional parameter and add check (https://github.com/ansible-collections/community.vmware/issues/397).
+- vmware_guest - Define sub-options of hardware and customization in argument_spec (https://github.com/ansible-collections/community.vmware/issues/555).
+- vmware_guest_register_operation - supported the check_mode
+- vmware_host_iscsi - added a name(iqn) changing option for iSCSI (https://github.com/ansible-collections/community.vmware/pull/617).
+- vmware_host_lockdown - Support check mode (https://github.com/ansible-collections/community.vmware/pull/633).
+
+Deprecated Features
+-------------------
+
+- vmware_host_firewall_manager - the creation of new rule with no ``allowed_ip`` entry in the ``allowed_hosts`` dictionary won't be allowed after 2.0.0 release.
+
+Bugfixes
+--------
+
+- vmware_content_library_manager - added support for subscribed library (https://github.com/ansible-collections/community.vmware/pull/569).
+- vmware_datastore_cluster_manager - Fix idempotency in check mode (https://github.com/ansible-collections/community.vmware/issues/623).
+- vmware_dvswitch - correctly add contact information (https://github.com/ansible-collections/community.vmware/issues/608).
+- vmware_dvswitch_lacp - typecast uplink number in lag_options (https://github.com/ansible-collections/community.vmware/issues/111).
+- vmware_guest - handle NoneType values before passing to ``len`` API (https://github.com/ansible-collections/community.vmware/issues/593).
+
+New Modules
+-----------
+
+- vmware_drs_group_manager - Manage VMs and Hosts in DRS group.
+- vmware_first_class_disk - Manage VMware vSphere First Class Disks
+
 v1.6.0
 ======
 

diff --git a/README.md b/README.md
@@ -60,6 +60,11 @@ Name | Description
 --- | ---
 [community.vmware.vmware](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_httpapi.rst)|HttpApi Plugin for VMware REST API
 
+### Inventory plugins
+Name | Description
+--- | ---
+[community.vmware.vmware_vm_inventory](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_vm_inventory_inventory.rst)|VMware Guest inventory source
+
 ### Modules
 Name | Description
 --- | ---
@@ -240,11 +245,6 @@ Name | Description
 [community.vmware.vsphere_copy](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vsphere_copy_module.rst)|Copy a file to a VMware datastore
 [community.vmware.vsphere_file](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vsphere_file_module.rst)|Manage files on a vCenter datastore
 
-### Inventory plugins
-Name | Description
---- | ---
-[community.vmware.vmware_vm_inventory](https://github.com/ansible-collections/community.vmware/blob/main/docs/community.vmware.vmware_vm_inventory_inventory.rst)|VMware Guest inventory source
-
 <!--end collection content-->
 
 ## Testing and Development

diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml
@@ -520,3 +520,49 @@ releases:
       name: vcenter_domain_user_group_info
       namespace: ''
     release_date: '2021-01-04'
+  1.7.0:
+    changes:
+      bugfixes:
+      - vmware_content_library_manager - added support for subscribed library (https://github.com/ansible-collections/community.vmware/pull/569).
+      - vmware_datastore_cluster_manager - Fix idempotency in check mode (https://github.com/ansible-collections/community.vmware/issues/623).
+      - vmware_dvswitch - correctly add contact information (https://github.com/ansible-collections/community.vmware/issues/608).
+      - vmware_dvswitch_lacp - typecast uplink number in lag_options (https://github.com/ansible-collections/community.vmware/issues/111).
+      - vmware_guest - handle NoneType values before passing to ``len`` API (https://github.com/ansible-collections/community.vmware/issues/593).
+      deprecated_features:
+      - vmware_host_firewall_manager - the creation of new rule with no ``allowed_ip``
+        entry in the ``allowed_hosts`` dictionary won't be allowed after 2.0.0 release.
+      minor_changes:
+      - vmware_cluster_info - added a parent datacenter name of Cluster to the return
+        value (https://github.com/ansible-collections/community.vmware/pull/591).
+      - vmware_content_deploy_ovf_template - consistent ``eagerZeroedThick`` value
+        (https://github.com/ansible-collections/community.vmware/issues/618).
+      - vmware_content_deploy_template - add datastore cluster parameter (https://github.com/ansible-collections/community.vmware/issues/397).
+      - vmware_content_deploy_template - make resource pool, host, cluster, datastore
+        optional parameter and add check (https://github.com/ansible-collections/community.vmware/issues/397).
+      - vmware_guest - Define sub-options of hardware and customization in argument_spec
+        (https://github.com/ansible-collections/community.vmware/issues/555).
+      - vmware_guest_register_operation - supported the check_mode
+      - vmware_host_iscsi - added a name(iqn) changing option for iSCSI (https://github.com/ansible-collections/community.vmware/pull/617).
+      - vmware_host_lockdown - Support check mode (https://github.com/ansible-collections/community.vmware/pull/633).
+    fragments:
+    - 111-vmware_dvswitch_loop.yml
+    - 397_vmware_content.yml
+    - 555-vmware_guest.yml
+    - 569_content_library.yml
+    - 591-vmware_cluster_info.yml
+    - 593_vmware_guest.yml
+    - 608_vmware_dvswitch.yml
+    - 617-vmware_host_iscsi.yml
+    - 618_vmware_content_deploy_ovf_template.yml
+    - 623-vmware_datastore_cluster_manager.yml
+    - 626-vmware_guest_register_operation.yml
+    - 633-vmware_host_lockdown.yml
+    - vmware_host_firewall_manager-prepare-all_ip-transition.yaml
+    modules:
+    - description: Manage VMs and Hosts in DRS group.
+      name: vmware_drs_group_manager
+      namespace: ''
+    - description: Manage VMware vSphere First Class Disks
+      name: vmware_first_class_disk
+      namespace: ''
+    release_date: '2021-02-01'
diff --git a/docs/community.vmware.vmware_content_deploy_ovf_template_module.rst b/docs/community.vmware.vmware_content_deploy_ovf_template_module.rst
@@ -329,7 +329,7 @@ Notes
 Examples
 --------
 
-.. code-block:: yaml+jinja
+.. code-block:: yaml
 
     - name: Deploy Virtual Machine from OVF template in content library
       community.vmware.vmware_content_deploy_ovf_template:

diff --git a/docs/community.vmware.vmware_content_deploy_template_module.rst b/docs/community.vmware.vmware_content_deploy_template_module.rst
@@ -357,7 +357,7 @@ Notes
 Examples
 --------
 
-.. code-block:: yaml+jinja
+.. code-block:: yaml
 
     - name: Deploy Virtual Machine from template in content library
       community.vmware.vmware_content_deploy_template:

diff --git a/docs/community.vmware.vmware_content_library_manager_module.rst b/docs/community.vmware.vmware_content_library_manager_module.rst
@@ -55,8 +55,8 @@ Parameters
                 </td>
                 <td>
                         <div>Name of the datastore on which backing content library is created.</div>
-                        <div>This is required only if <code>state</code> is set to <code>present</code>.</div>
-                        <div>This parameter is ignored, when <code>state</code> is set to <code>absent</code>.</div>
+                        <div>This is required only if <em>state</em> is set to <code>present</code>.</div>
+                        <div>This parameter is ignored, when <em>state</em> is set to <code>absent</code>.</div>
                         <div>Currently only datastore backing creation is supported.</div>
                         <div style="font-size: small; color: darkgreen"><br/>aliases: datastore</div>
                 </td>
@@ -91,8 +91,8 @@ Parameters
                 </td>
                 <td>
                         <div>The content library description.</div>
-                        <div>This is required only if <code>state</code> is set to <code>present</code>.</div>
-                        <div>This parameter is ignored, when <code>state</code> is set to <code>absent</code>.</div>
+                        <div>This is required only if <em>state</em> is set to <code>present</code>.</div>
+                        <div>This parameter is ignored, when <em>state</em> is set to <code>absent</code>.</div>
                         <div>Process of updating content library only allows description change.</div>
                 </td>
             </tr>
@@ -129,8 +129,8 @@ Parameters
                 </td>
                 <td>
                         <div>The content library type.</div>
-                        <div>This is required only if <code>state</code> is set to <code>present</code>.</div>
-                        <div>This parameter is ignored, when <code>state</code> is set to <code>absent</code>.</div>
+                        <div>This is required only if <em>state</em> is set to <code>present</code>.</div>
+                        <div>This parameter is ignored, when <em>state</em> is set to <code>absent</code>.</div>
                 </td>
             </tr>
             <tr>
@@ -186,6 +186,25 @@ Parameters
                         <div>The connection to protocol.</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>ssl_thumbprint</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 1.7.0</div>
+                </td>
+                <td>
+                </td>
+                <td>
+                        <div>The SHA1 SSL thumbprint of the subscribed content library to subscribe to.</div>
+                        <div>This is required only if <em>library_type</em> is set to <code>subscribed</code> and the library is https.</div>
+                        <div>This parameter is ignored, when <em>state</em> is set to <code>absent</code>.</div>
+                        <div>The information can be extracted using openssl using the following example: <code>echo | openssl s_client -connect test-library.com:443 |&amp; openssl x509 -fingerprint -noout</code></div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="1">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -209,6 +228,48 @@ Parameters
                         <div>If set to <code>absent</code> and library does not exists, no action is taken.</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>subscription_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>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 1.7.0</div>
+                </td>
+                <td>
+                </td>
+                <td>
+                        <div>The url of the content library to subscribe to.</div>
+                        <div>This is required only if <em>library_type</em> is set to <code>subscribed</code>.</div>
+                        <div>This parameter is ignored, when <em>state</em> is set to <code>absent</code>.</div>
+                </td>
+            </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>update_on_demand</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">boolean</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 1.7.0</div>
+                </td>
+                <td>
+                        <ul style="margin: 0; padding: 0"><b>Choices:</b>
+                                    <li><div style="color: blue"><b>no</b>&nbsp;&larr;</div></li>
+                                    <li>yes</li>
+                        </ul>
+                </td>
+                <td>
+                        <div>Whether to download all content on demand.</div>
+                        <div>If set to <code>True</code>, all content will be downloaded on demand.</div>
+                        <div>If set to <code>False</code> content will be downloaded ahead of time.</div>
+                        <div>This is required only if <em>library_type</em> is set to <code>subscribed</code>.</div>
+                        <div>This parameter is ignored, when <em>state</em> is set to <code>absent</code>.</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="1">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -255,7 +316,7 @@ Notes
 -----
 
 .. note::
-   - Tested on vSphere 6.5, 6.7
+   - Tested on vSphere 6.5, 6.7, and 7.0
 
 
 
@@ -264,7 +325,7 @@ Examples
 
 .. code-block:: yaml
 
-    - name: Create Content Library
+    - name: Create Local Content Library
       community.vmware.vmware_content_library_manager:
         hostname: '{{ vcenter_hostname }}'
         username: '{{ vcenter_username }}'
@@ -276,6 +337,21 @@ Examples
         state: present
       delegate_to: localhost
 
+    - name: Create Subscribed Content Library
+      community.vmware.vmware_content_library_manager:
+        hostname: '{{ vcenter_hostname }}'
+        username: '{{ vcenter_username }}'
+        password: '{{ vcenter_password }}'
+        library_name: test-content-lib
+        library_description: 'Subscribed Library with Datastore Backing'
+        library_type: subscribed
+        datastore_name: datastore
+        subscription_url: 'https://library.url'
+        ssl_thumbprint: 'aa:bb:cc:dd:ee:ff:gg:hh:ii:jj:kk:ll:mm:nn:oo:pp:qq:rr:ss:tt'
+        update_on_demand: true
+        state: present
+      delegate_to: localhost
+
     - name: Update Content Library
       community.vmware.vmware_content_library_manager:
         hostname: '{{ vcenter_hostname }}'

diff --git a/docs/community.vmware.vmware_drs_group_manager_module.rst b/docs/community.vmware.vmware_drs_group_manager_module.rst
@@ -285,7 +285,7 @@ Notes
 Examples
 --------
 
-.. code-block:: yaml+jinja
+.. code-block:: yaml
 
     ---
     - name: Add VMs in an existing DRS VM group

diff --git a/docs/community.vmware.vmware_first_class_disk_module.rst b/docs/community.vmware.vmware_first_class_disk_module.rst
@@ -8,6 +8,7 @@ community.vmware.vmware_first_class_disk
 **Manage VMware vSphere First Class Disks**
 
 
+Version added: 1.7.0
 
 .. contents::
    :local:
@@ -16,7 +17,7 @@ community.vmware.vmware_first_class_disk
 
 Synopsis
 --------
-- This module can be used to manage (create, delete) VMware vSphere First Class Disks.
+- This module can be used to manage (create, delete, resize) VMware vSphere First Class Disks.