Merge pull request #471 from Checkmk/devel

Update changelogs and docs

CHANGELOG.rst

@@ -5,6 +5,33 @@ checkmk.general Release Notes
 .. contents:: Topics
 
 
+v3.4.0
+======
+
+Release Summary
+---------------
+
+Supporting managed service providers, admins and security. All in one release.
+
+Minor Changes
+-------------
+
+- Agent role - Avoid logging passwords by default for extra security
+- Agent role - Introduce variable to configure agent mode. Refer to the README.
+- Contact group module - Add support for the Checkmk Managed Edition (CME).
+- Host group module - Add support for the Checkmk Managed Edition (CME).
+- Password module - Add support for the Checkmk Managed Edition (CME).
+- Server role - Add new states "enabled" and "disabled" for site management.
+- Server role - Avoid logging passwords by default for extra security
+- Server role - Enable configuration of omd config values. Refer to the README for details.
+- Service group module - Add support for the Checkmk Managed Edition (CME).
+- User module - Add support for the Checkmk Managed Edition (CME).
+
+Bugfixes
+--------
+
+- Agent role - Fix agent port check for agent modes other than "pull".
+
 v3.3.0
 ======
 

changelogs/.plugin-cache.yaml

@@ -72,7 +72,7 @@ plugins:
       namespace: ''
       version_added: 0.11.0
     password:
-      description: Manage passwords in checkmk.
+      description: Manage passwords in Checkmk.
       name: password
       namespace: ''
       version_added: 2.3.0
@@ -106,4 +106,4 @@ plugins:
   strategy: {}
   test: {}
   vars: {}
-version: 3.3.0
+version: 3.4.0

changelogs/changelog.yaml

@@ -723,3 +723,28 @@ releases:
         name: hosts
         namespace: null
     release_date: '2023-11-02'
+  3.4.0:
+    changes:
+      bugfixes:
+      - Agent role - Fix agent port check for agent modes other than "pull".
+      minor_changes:
+      - Agent role - Avoid logging passwords by default for extra security
+      - Agent role - Introduce variable to configure agent mode. Refer to the README.
+      - Contact group module - Add support for the Checkmk Managed Edition (CME).
+      - Host group module - Add support for the Checkmk Managed Edition (CME).
+      - Password module - Add support for the Checkmk Managed Edition (CME).
+      - Server role - Add new states "enabled" and "disabled" for site management.
+      - Server role - Avoid logging passwords by default for extra security
+      - Server role - Enable configuration of omd config values. Refer to the README
+        for details.
+      - Service group module - Add support for the Checkmk Managed Edition (CME).
+      - User module - Add support for the Checkmk Managed Edition (CME).
+      release_summary: Supporting managed service providers, admins and security.
+        All in one release.
+    fragments:
+    - agent_push.yml
+    - cme_support.yml
+    - no_log.yml
+    - release_summary.yml
+    - server-omd-config.yml
+    release_date: '2023-11-09'

docs/activation_module.rst

@@ -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 3.3.0).
+    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.

docs/bakery_module.rst

@@ -23,7 +23,7 @@ checkmk.general.bakery module -- Trigger baking and signing in the agent bakery.
 .. Collection note
 
 .. note::
-    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.

docs/contact_group_module.rst

@@ -23,7 +23,7 @@ checkmk.general.contact_group module -- Manage contact groups in Checkmk (bulk v
 .. Collection note
 
 .. note::
-    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.
@@ -143,6 +143,40 @@ Parameters
       The automation user you want to use. It has to be an 'Automation' user, not a normal one.
 
 
+      .. raw:: html
+
+        </div>
+
+  * - .. raw:: html
+
+        <div class="ansible-option-cell">
+        <div class="ansibleOptionAnchor" id="parameter-customer"></div>
+
+      .. _ansible_collections.checkmk.general.contact_group_module__parameter-customer:
+
+      .. rst-class:: ansible-option-title
+
+      **customer**
+
+      .. raw:: html
+
+        <a class="ansibleOptionLink" href="#parameter-customer" title="Permalink to this option"></a>
+
+      .. ansible-option-type-line::
+
+        :ansible-option-type:`string`
+
+      .. raw:: html
+
+        </div>
+
+    - .. raw:: html
+
+        <div class="ansible-option-cell">
+
+      For the Checkmk Managed Edition (CME), you need to specify which customer ID this object belongs to.
+
+
       .. raw:: html
 
         </div>
@@ -432,6 +466,7 @@ Examples
         automation_secret: "$SECRET"
         name: "my_contact_group"
         title: "My Contact Group"
+        customer: "provider"
         state: "present"
 
     # Create several contact groups.
@@ -441,6 +476,7 @@ Examples
         site: "my_site"
         automation_user: "automation"
         automation_secret: "$SECRET"
+        customer: "provider"
         groups:
           - name: "my_contact_group_one"
             title: "My Contact Group One"
@@ -457,6 +493,7 @@ Examples
         site: "my_site"
         automation_user: "automation"
         automation_secret: "$SECRET"
+        customer: "provider"
         groups:
           - name: "my_contact_group_one"
             title: "My Contact Group One"

docs/discovery_module.rst

@@ -23,7 +23,7 @@ checkmk.general.discovery module -- Discover services in Checkmk.
 .. Collection note
 
 .. note::
-    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.

docs/downtime_module.rst

@@ -23,7 +23,7 @@ checkmk.general.downtime module -- Manage downtimes in Checkmk.
 .. Collection note
 
 .. note::
-    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.

docs/folder_lookup.rst

@@ -23,7 +23,7 @@ checkmk.general.folder lookup -- Get folder attributes
 .. Collection note
 
 .. note::
-    This lookup plugin is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This lookup plugin is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.

docs/folder_module.rst

@@ -23,7 +23,7 @@ checkmk.general.folder module -- Manage folders in Checkmk.
 .. Collection note
 
 .. note::
-    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.

docs/folders_lookup.rst

@@ -23,7 +23,7 @@ checkmk.general.folders lookup -- Get various information about a folder
 .. Collection note
 
 .. note::
-    This lookup plugin is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This lookup plugin is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.

docs/host_group_module.rst

@@ -23,7 +23,7 @@ checkmk.general.host_group module -- Manage host groups in Checkmk (bulk version
 .. Collection note
 
 .. note::
-    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.
@@ -143,6 +143,40 @@ Parameters
       The automation user you want to use. It has to be an 'Automation' user, not a normal one.
 
 
+      .. raw:: html
+
+        </div>
+
+  * - .. raw:: html
+
+        <div class="ansible-option-cell">
+        <div class="ansibleOptionAnchor" id="parameter-customer"></div>
+
+      .. _ansible_collections.checkmk.general.host_group_module__parameter-customer:
+
+      .. rst-class:: ansible-option-title
+
+      **customer**
+
+      .. raw:: html
+
+        <a class="ansibleOptionLink" href="#parameter-customer" title="Permalink to this option"></a>
+
+      .. ansible-option-type-line::
+
+        :ansible-option-type:`string`
+
+      .. raw:: html
+
+        </div>
+
+    - .. raw:: html
+
+        <div class="ansible-option-cell">
+
+      For the Checkmk Managed Edition (CME), you need to specify which customer ID this object belongs to.
+
+
       .. raw:: html
 
         </div>
@@ -432,6 +466,7 @@ Examples
         automation_secret: "$SECRET"
         name: "my_host_group"
         title: "My Host Group"
+        customer: "provider"
         state: "present"
 
     # Create several host groups.
@@ -441,6 +476,7 @@ Examples
         site: "my_site"
         automation_user: "automation"
         automation_secret: "$SECRET"
+        customer: "provider"
         groups:
           - name: "my_host_group_one"
             title: "My Host Group One"
@@ -457,6 +493,7 @@ Examples
         site: "my_site"
         automation_user: "automation"
         automation_secret: "$SECRET"
+        customer: "provider"
         groups:
           - name: "my_host_group_one"
             title: "My Host Group One"

docs/host_lookup.rst

@@ -23,7 +23,7 @@ checkmk.general.host lookup -- Get host attributes
 .. Collection note
 
 .. note::
-    This lookup plugin is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This lookup plugin is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.

docs/host_module.rst

@@ -23,7 +23,7 @@ checkmk.general.host module -- Manage hosts in Checkmk.
 .. Collection note
 
 .. note::
-    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This module is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.

docs/hosts_lookup.rst

@@ -23,7 +23,7 @@ checkmk.general.hosts lookup -- Get various information about a host
 .. Collection note
 
 .. note::
-    This lookup plugin is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.3.0).
+    This lookup plugin is part of the `checkmk.general collection <https://galaxy.ansible.com/ui/repo/published/checkmk/general/>`_ (version 3.4.0).
 
     It is not included in ``ansible-core``.
     To check whether it is installed, run :code:`ansible-galaxy collection list`.

docs/index.rst

@@ -9,7 +9,7 @@
 Checkmk.General
 ===============
 
-Collection version 3.3.0
+Collection version 3.4.0
 
 .. contents::
    :local:
@@ -64,7 +64,7 @@ Modules
 * :ansplugin:`folder module <checkmk.general.folder#module>` -- Manage folders in Checkmk.
 * :ansplugin:`host module <checkmk.general.host#module>` -- Manage hosts in Checkmk.
 * :ansplugin:`host_group module <checkmk.general.host_group#module>` -- Manage host groups in Checkmk (bulk version).
-* :ansplugin:`password module <checkmk.general.password#module>` -- Manage passwords in checkmk.
+* :ansplugin:`password module <checkmk.general.password#module>` -- Manage passwords in Checkmk.
 * :ansplugin:`rule module <checkmk.general.rule#module>` -- Manage rules in Checkmk.
 * :ansplugin:`service_group module <checkmk.general.service_group#module>` -- Manage service groups in Checkmk (bulk version).
 * :ansplugin:`tag_group module <checkmk.general.tag_group#module>` -- Manage tag\_group within Checkmk