Merge branch 'devel' into build/checkmk-2-3-support

.github/workflows/release.yaml

@@ -132,7 +132,7 @@ jobs:
 
       - name: Create Release and upload Assets
         id: create-release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           draft: false

CHANGELOG.rst

@@ -4,6 +4,46 @@ checkmk.general Release Notes
 
 .. contents:: Topics
 
+v4.3.1
+======
+
+Release Summary
+---------------
+
+Bugfix Release.
+
+Bugfixes
+--------
+
+- Rule module - Fix empty rule conditions.
+
+v4.3.0
+======
+
+Release Summary
+---------------
+
+Reworking the CI, enhancing code quality and improving modules.
+
+Minor Changes
+-------------
+
+- Folder module - Extend attribute management. Please refer to the module documentation for more details.
+- Lookup modules - Enable usage of ini files, environment and inventory variables to configure basic settings for the lookup plugins, like e.g., the server_url or site alongside the authentication options. Refer to the module documentation for details.
+- Rule module - Introduce rule_id to uniquely identify rules. This ID can be retrieved e.g., using the lookup plugin. Refer to the module documentation for further details.
+
+Bugfixes
+--------
+
+- Folder module - Fix idempotency when using "attributes" parameter for creating a folder.
+- Folder module - Parents will be parsed properly now. This means, that parents given as a string will now be parsed as a list of one.
+- Host module - Parents will be parsed properly now. This means, that parents given as a string will now be parsed as a list of one.
+- User module - Fix bug, where an absent user was created, if 'reset_password' was used.
+
+Known Issues
+------------
+
+- Lookup modules - When using inventory variables to configure e.g., the server_url, it is not possible to assign other variables to these variables. This is a limitation of Ansble itself.
 
 v4.2.0
 ======
@@ -604,7 +644,6 @@ Major Changes
 Minor Changes
 -------------
 
-
 v0.12.0
 =======
 

README.md

@@ -8,7 +8,9 @@ Checkmk and keep your daily operations smooth and efficient.
 ## Here be dragons!
 
 This collection is provided AS IS and we cannot guarantee proper functionality.
+
 Additionally, there is no commercial support whatsoever!
+
 This is an open source endeavour, on which we want to collaborate with the community.
 
 [![Ansible Sanity Tests](https://github.com/Checkmk/ansible-collection-checkmk.general/actions/workflows/ansible-sanity-tests.yaml/badge.svg)](https://github.com/Checkmk/ansible-collection-checkmk.general/actions/workflows/ansible-sanity-tests.yaml)
@@ -42,6 +44,8 @@ Name | Description
 -->
 
 ### Lookup plugins
+Click on the lookup plugin name below, to get detailed documentation about it.
+For more in-depth documentation, see [this README](https://github.com/Checkmk/ansible-collection-checkmk.general/blob/main/plugins/lookup/README.md).
 
 Name | Description | Tests
 --- | --- | ---
@@ -57,6 +61,7 @@ Name | Description | Tests
 [checkmk.general.version](https://github.com/Checkmk/ansible-collection-checkmk.general/blob/main/plugins/lookup/version.py)|Look up version and edition information.|[![Integration Tests for Version Lookup Module](https://github.com/Checkmk/ansible-collection-checkmk.general/actions/workflows/ans-int-test-lkp-version.yaml/badge.svg)](https://github.com/Checkmk/ansible-collection-checkmk.general/actions/workflows/ans-int-test-lkp-version.yaml)
 
 ### Modules
+Click on the module name below, to get detailed documentation about it.
 
 Name | Description | Tests
 --- | --- | ---
@@ -74,6 +79,7 @@ Name | Description | Tests
 [checkmk.general.user](https://github.com/Checkmk/ansible-collection-checkmk.general/blob/main/plugins/modules/user.py)|Manage users.|[![Integration Tests for User Module](https://github.com/Checkmk/ansible-collection-checkmk.general/actions/workflows/ans-int-test-user.yaml/badge.svg)](https://github.com/Checkmk/ansible-collection-checkmk.general/actions/workflows/ans-int-test-user.yaml)
 
 ### Roles
+Click on the role name below, to get documentation about the role.
 
 Name | Description | Tests
 --- | --- | ---

SUPPORT.md

@@ -49,3 +49,5 @@ Collection Version | Checkmk Versions | Ansible Versions | Remarks
 4.0.1 | 2.0.0p39, 2.1.0p36, 2.2.0p16 | 2.14, 2.15, 2.16 | None
 4.1.0 | 2.0.0p39, 2.1.0p37, 2.2.0p17 | 2.14, 2.15, 2.16 | None
 4.2.0 | 2.0.0p39, 2.1.0p38, 2.2.0p19 | 2.14, 2.15, 2.16 | None
+4.3.0 | 2.0.0p39, 2.1.0p39, 2.2.0p22 | 2.14, 2.15, 2.16 | None
+4.3.1 | 2.0.0p39, 2.1.0p39, 2.2.0p22 | 2.14, 2.15, 2.16 | None

changelogs/.plugin-cache.yaml

@@ -31,15 +31,15 @@ plugins:
       name: hosts
       version_added: 3.3.0
     rule:
-      description: Show rule
+      description: Show a rule
       name: rule
       version_added: 3.5.0
     rules:
-      description: List rules
+      description: Get a list rules
       name: rules
       version_added: 3.5.0
     ruleset:
-      description: Show ruleset
+      description: Show a ruleset
       name: ruleset
       version_added: 3.5.0
     rulesets:
@@ -126,4 +126,4 @@ plugins:
   strategy: {}
   test: {}
   vars: {}
-version: 4.2.0
+version: 4.3.1

changelogs/archive/4.3.0/folder.yml

@@ -0,0 +1,3 @@
+minor_changes:
+  - Folder module - Extend attribute management. Please refer to the module documentation
+    for more details.

changelogs/archive/4.3.0/lookups.yml

@@ -0,0 +1,9 @@
+minor_changes:
+  - Lookup modules - Enable usage of ini files, environment and inventory variables
+    to configure basic settings for the lookup plugins, like e.g., the server_url or site
+    alongside the authentication options. Refer to the module documentation for details.
+
+known_issues:
+  - Lookup modules - When using inventory variables to configure e.g., the server_url,
+    it is not possible to assign other variables to these variables.
+    This is a limitation of Ansble itself.

changelogs/archive/4.3.0/parents.yml

@@ -0,0 +1,5 @@
+bugfixes:
+  - Host module - Parents will be parsed properly now.
+    This means, that parents given as a string will now be parsed as a list of one.
+  - Folder module - Parents will be parsed properly now.
+    This means, that parents given as a string will now be parsed as a list of one.

changelogs/archive/4.3.0/release_summary.yml

@@ -0,0 +1 @@
+release_summary: "Reworking the CI, enhancing code quality and improving modules."

changelogs/archive/4.3.0/rule.yml

@@ -0,0 +1,4 @@
+minor_changes:
+  - Rule module - Introduce rule_id to uniquely identify rules.
+    This ID can be retrieved e.g., using the lookup plugin.
+    Refer to the module documentation for further details.

changelogs/archive/4.3.0/user.yml

@@ -0,0 +1,2 @@
+bugfixes:
+  - User module - Fix bug, where an absent user was created, if 'reset_password' was used.

changelogs/archive/4.3.1/fix_rule_conditions_missing.yml

@@ -0,0 +1,2 @@
+bugfixes:
+ - Rule module - Fix empty rule conditions.

changelogs/archive/4.3.1/release_summary.yml

@@ -0,0 +1 @@
+release_summary: "Bugfix Release."

changelogs/changelog.yaml

@@ -823,3 +823,47 @@ releases:
     - tag_group.yml
     - user.yml
     release_date: '2024-01-23'
+  4.3.0:
+    changes:
+      bugfixes:
+      - Folder module - Fix idempotency when using "attributes" parameter for creating
+        a folder.
+      - Folder module - Parents will be parsed properly now. This means, that parents
+        given as a string will now be parsed as a list of one.
+      - Host module - Parents will be parsed properly now. This means, that parents
+        given as a string will now be parsed as a list of one.
+      - User module - Fix bug, where an absent user was created, if 'reset_password'
+        was used.
+      known_issues:
+      - Lookup modules - When using inventory variables to configure e.g., the server_url,
+        it is not possible to assign other variables to these variables. This is a
+        limitation of Ansble itself.
+      minor_changes:
+      - Folder module - Extend attribute management. Please refer to the module documentation
+        for more details.
+      - Lookup modules - Enable usage of ini files, environment and inventory variables
+        to configure basic settings for the lookup plugins, like e.g., the server_url
+        or site alongside the authentication options. Refer to the module documentation
+        for details.
+      - Rule module - Introduce rule_id to uniquely identify rules. This ID can be
+        retrieved e.g., using the lookup plugin. Refer to the module documentation
+        for further details.
+      release_summary: Reworking the CI, enhancing code quality and improving modules.
+    fragments:
+    - fix_folder_module_idempotency.yml
+    - folder.yml
+    - lookups.yml
+    - parents.yml
+    - release_summary.yml
+    - rule.yml
+    - user.yml
+    release_date: '2024-02-16'
+  4.3.1:
+    changes:
+      bugfixes:
+      - Rule module - Fix empty rule conditions.
+      release_summary: Bugfix Release.
+    fragments:
+    - fix_rule_conditions_missing.yml
+    - release_summary.yml
+    release_date: '2024-02-21'

changelogs/template.yml

@@ -21,12 +21,20 @@
 # For changes that are not really scoped (for example, which affect a whole collection), use the following format:
 # - Description starting with an uppercase letter and ending with a dot at the very end. Multiple sentences are allowed.
 
+# Tipps:
+# You can write multi line changelogs like this:
+# - Module name - This is a very long and detailed
+#   changelog line, so we will split it into several
+#   lines, just like this.
+
 ## Possible keys:
 #
 # release_summary
 #     Adds a single line release summary to the changelog.
 # breaking_changes
-#     Changes that break existing playbooks or roles. This includes any change to existing behavior that forces users to update tasks. Displayed in both the changelogs and the Porting Guides.
+#     Changes that break existing playbooks or roles.
+#     This includes any change to existing behavior that forces users to update tasks.
+#     Displayed in both the changelogs and the Porting Guides.
 # major_changes
 #     Major changes to Ansible itself. Generally does not include module or plugin changes. Displayed in both the changelogs and the Porting Guides.
 # minor_changes

docs/activation_module.rst

@@ -7,7 +7,7 @@
     :trim:
 
 .. meta::
-  :antsibull-docs: 2.6.1
+  :antsibull-docs: 2.7.0
 
 .. Anchors
 
@@ -23,7 +23,7 @@ checkmk.general.activation module -- Activate changes in Checkmk.
 .. Collection note
 
 .. note::
-    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 4.2.0).
+    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 4.3.1).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.
@@ -259,7 +259,7 @@ Parameters
 
         <div class="ansible-option-cell">
 
-      The base url of your Checkmk server.
+      The base url of your Checkmk server including the protocol.
 
 
       .. raw:: html