Prepare for v1.10.0 release (#357)

ansible-collections · May 13, 2022 · d489bff · d489bff
1 parent 4a175e5
commit d489bff
Show file tree

Hide file tree

Showing 13 changed files with 52 additions and 16 deletions.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -5,13 +5,29 @@ Ansible Windows Release Notes
 .. contents:: Topics
 
 
-v1.9.0
-======
+v1.10.0
+=======
 
 Release Summary
 ---------------
 
-- Release summary for v1.9.0
+Release summary for v1.10.0
+
+Minor Changes
+-------------
+
+- setup - Added ipv4, ipv6, mtu and speed data to ansible_interfaces
+- win_environment - Trigger ``WM_SETTINGCHANGE`` on a change to notify other host processes of an environment change
+- win_path - Migrate to newer style module parser that adds features like module invocation under ``-vvv``
+- win_path - Trigger ``WM_SETTINGCHANGE`` on a change to notify other host processes of an environment change
+
+Bugfixes
+--------
+
+- win_reboot - Always set a minimum of 2 seconds for ``pre_reboot_delay`` to ensure the plugin can read the result
+
+v1.9.0
+======
 
 Minor Changes
 -------------

diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml
@@ -162,6 +162,26 @@ releases:
     - 1.0.1-summary.yml
     - win_copy-single-fix.yml
     release_date: '2020-09-26'
+  1.10.0:
+    changes:
+      bugfixes:
+      - win_reboot - Always set a minimum of 2 seconds for ``pre_reboot_delay`` to
+        ensure the plugin can read the result
+      minor_changes:
+      - setup - Added ipv4, ipv6, mtu and speed data to ansible_interfaces
+      - win_environment - Trigger ``WM_SETTINGCHANGE`` on a change to notify other
+        host processes of an environment change
+      - win_path - Migrate to newer style module parser that adds features like module
+        invocation under ``-vvv``
+      - win_path - Trigger ``WM_SETTINGCHANGE`` on a change to notify other host processes
+        of an environment change
+      release_summary: Release summary for v1.10.0
+    fragments:
+    - environment_notify.yml
+    - release-v1.10.0.yml
+    - setup_more_interface_data.yml
+    - win_reboot-pre-delay.yml
+    release_date: '2022-05-13'
   1.2.0:
     fragments:
     - 1.1.0-release.yml
@@ -398,8 +418,6 @@ releases:
         text was changed.
       - win_powershell - Added ``$Ansible.Verbosity`` for scripts to adjust code based
         on the verbosity Ansible is running as
-      release_summary:
-      - Release summary for v1.9.0
     fragments:
     - release-1.9.0.yml
     - win_command-shell-time.yml

diff --git a/changelogs/fragments/environment_notify.yml b/changelogs/fragments/environment_notify.yml
diff --git a/changelogs/fragments/setup_more_interface_data.yml b/changelogs/fragments/setup_more_interface_data.yml
diff --git a/changelogs/fragments/win_reboot-pre-delay.yml b/changelogs/fragments/win_reboot-pre-delay.yml
diff --git a/docs/ansible.windows.win_dns_client_module.rst b/docs/ansible.windows.win_dns_client_module.rst
@@ -39,6 +39,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                          / <span style="color: red">required</span>
                     </div>
                 </td>
@@ -56,6 +57,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                          / <span style="color: red">required</span>
                     </div>
                 </td>

diff --git a/docs/ansible.windows.win_feature_module.rst b/docs/ansible.windows.win_feature_module.rst
@@ -79,6 +79,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                          / <span style="color: red">required</span>
                     </div>
                 </td>

diff --git a/docs/ansible.windows.win_group_membership_module.rst b/docs/ansible.windows.win_group_membership_module.rst
@@ -39,6 +39,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                          / <span style="color: red">required</span>
                     </div>
                 </td>

diff --git a/docs/ansible.windows.win_path_module.rst b/docs/ansible.windows.win_path_module.rst
@@ -39,6 +39,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                          / <span style="color: red">required</span>
                     </div>
                 </td>
@@ -100,7 +101,7 @@ Parameters
                 <td>
                         <ul style="margin: 0; padding: 0"><b>Choices:</b>
                                     <li>absent</li>
-                                    <li>present</li>
+                                    <li><div style="color: blue"><b>present</b>&nbsp;&larr;</div></li>
                         </ul>
                 </td>
                 <td>

diff --git a/docs/ansible.windows.win_reboot_module.rst b/docs/ansible.windows.win_reboot_module.rst
@@ -16,7 +16,7 @@ ansible.windows.win_reboot
 
 Synopsis
 --------
-- Reboot a Windows machine, wait for it to go down, come back up, and respond to commands.
+- Unconditionally reboot a Windows machine, wait for it to go down, come back up, and respond to commands.
 - For non-Windows targets, use the :ref:`ansible.builtin.reboot <ansible.builtin.reboot_module>` module instead.
 
 
@@ -115,6 +115,7 @@ Parameters
                 </td>
                 <td>
                         <div>Seconds to wait before reboot. Passed as a parameter to the reboot command.</div>
+                        <div>The minimum version is <code>2</code> seconds and cannot be set lower.</div>
                         <div style="font-size: small; color: darkgreen"><br/>aliases: pre_reboot_delay_sec</div>
                 </td>
             </tr>
@@ -163,6 +164,7 @@ Notes
    - If a shutdown was already scheduled on the system, :ref:`ansible.windows.win_reboot <ansible.windows.win_reboot_module>` will abort the scheduled shutdown and enforce its own shutdown.
    - Beware that when :ref:`ansible.windows.win_reboot <ansible.windows.win_reboot_module>` returns, the Windows system may not have settled yet and some base services could be in limbo. This can result in unexpected behavior. Check the examples for ways to mitigate this. This has been slightly mitigated in the ``1.6.0`` release of ``ansible.windows`` but it is not guranteed to always wait until the logon prompt is shown.
    - The connection user must have the ``SeRemoteShutdownPrivilege`` privilege enabled, see https://docs.microsoft.com/en-us/windows/security/threat-protection/security-policy-settings/force-shutdown-from-a-remote-system for more information.
+   - This module is equivalent to using the /f forced option for reboot on a windows host
 
 
 See Also

diff --git a/docs/ansible.windows.win_wait_for_module.rst b/docs/ansible.windows.win_wait_for_module.rst
@@ -74,6 +74,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                     </div>
                 </td>
                 <td>

diff --git a/galaxy.yml b/galaxy.yml
@@ -1,6 +1,6 @@
 namespace: ansible
 name: windows
-version: 1.9.0
+version: 1.10.0
 readme: README.md
 authors:
 - Jordan Borean @jborean93

diff --git a/tests/unit/plugins/action/test_win_updates.py b/tests/unit/plugins/action/test_win_updates.py
@@ -122,10 +122,12 @@ def mock_connection_init(test_id, default_rc=0, default_stderr=b''):
 def win_updates_init(task_args, async_val=0, check_mode=False, connection=None):
     task = MagicMock(Task)
     task.args = task_args
+    task.check_mode = check_mode
     task.async_val = async_val
 
     connection = connection or MagicMock()
 
+    # Used for older Ansible versions
     play_context = MagicMock()
     play_context.check_mode = check_mode