Add the DCD module donated by Atruvia AG

.github/labels-issues.yml

@@ -23,6 +23,9 @@ module:bakery:
 module:contact_group:
   - 'Component Name: contact_group'
 
+module:dcd:
+  - 'Component Name: dcd'
+
 module:discovery:
   - 'Component Name: discovery'
 

.github/labels-prs.yml

@@ -34,6 +34,11 @@ module:contact_group:
       - changed-files:
           - any-glob-to-any-file: 'plugins/modules/contact_group.py'
 
+module:dcd:
+  - any:
+      - changed-files:
+          - any-glob-to-any-file: 'plugins/modules/dcd.py'
+
 module:discovery:
   - any:
       - changed-files:

.github/workflows/ans-int-test-dcd.yaml

@@ -0,0 +1,95 @@
+# README:
+# - When changing the module name, it needs to be changed in 'env:MODULE_NAME' and in 'on:pull_requests:path'!
+#
+# Resources:
+# - Template for this file: https://github.com/ansible-collections/collection_template/blob/main/.github/workflows/ansible-test.yml
+# - About Ansible integration tests: https://docs.ansible.com/ansible/latest/dev_guide/testing_integration.html
+
+env:
+  NAMESPACE: checkmk
+  COLLECTION_NAME: general
+  MODULE_NAME: dcd
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+name: Ansible Integration Tests for DCD Module
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 0 * * 0'
+  pull_request:
+    branches:
+      - main
+      - devel
+    paths:
+      - 'plugins/modules/dcd.py'
+  push:
+    paths:
+      - '.github/workflows/ans-int-test-dcd.yaml'
+      - 'plugins/modules/dcd.py'
+      - 'tests/integration/files/includes/'
+      - 'tests/integration/targets/activation/'
+
+jobs:
+
+  integration:
+    runs-on: ubuntu-24.04
+    name: Ⓐ${{ matrix.ansible }}+py${{ matrix.python }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ansible:
+          - stable-2.17
+          - stable-2.18
+          - stable-2.19
+          - devel
+        python:
+          - '3.11'
+          - '3.12'
+        exclude:
+          # Exclude unsupported sets.
+          - ansible: devel
+            python: '3.11'
+
+    services:
+      old_cme:
+        image: checkmk/check-mk-managed:2.3.0p38
+        ports:
+          - 5323:5000
+        env:
+          CMK_SITE_ID: "old_cme"
+          CMK_PASSWORD: "Sup3rSec4et!"
+      stable_cme:
+        image: checkmk/check-mk-managed:2.4.0p13
+        ports:
+          - 5324:5000
+        env:
+          CMK_SITE_ID: "stable_cme"
+          CMK_PASSWORD: "Sup3rSec4et!"
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v5
+        with:
+          path: ansible_collections/${{env.NAMESPACE}}/${{env.COLLECTION_NAME}}
+
+      - name: "Install uv and set the python version."
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python }}
+          enable-cache: true
+          working-directory: ./ansible_collections/${{env.NAMESPACE}}/${{env.COLLECTION_NAME}}/
+
+      - name: "Setup uv venv."
+        run: uv venv
+        working-directory: ./ansible_collections/${{env.NAMESPACE}}/${{env.COLLECTION_NAME}}
+
+      - name: Install ansible-base (${{ matrix.ansible }})
+        run: uv pip install https://github.com/ansible/ansible/archive/${{ matrix.ansible }}.tar.gz
+        working-directory: ./ansible_collections/${{env.NAMESPACE}}/${{env.COLLECTION_NAME}}
+
+      - name: Run integration test
+        run: uv run ansible-test integration ${{env.MODULE_NAME}} -v --color --continue-on-error --diff --python ${{ matrix.python }}
+        working-directory: ./ansible_collections/${{env.NAMESPACE}}/${{env.COLLECTION_NAME}}

changelogs/fragments/dcd.yml

@@ -0,0 +1,2 @@
+minor_changes:
+  - DCD module - Add DCD module.

meta/runtime.yml

@@ -5,6 +5,7 @@ action_groups:
     - activation
     - bakery
     - contact_group
+    - dcd
     - discovery
     - downtime
     - folder

playbooks/demo/dcd.yml

@@ -0,0 +1,129 @@
+---
+- name: "Showcase dcd module."
+  hosts: test
+  strategy: linear
+  gather_facts: false
+  vars_files:
+    - ../vars/auth.yml      # This vars file provides details about your site
+    - ../vars/folders.yml   # This vars file contains the folders to manage
+    - ../vars/dcd.yml    # This vars file contains the groups to manage
+  tasks:
+    # - name: "Gather Date and Time Facts on localhost."
+    #   ansible.builtin.setup:
+    #     gather_subset:
+    #       - date_time
+    #   delegate_to: localhost
+    #   run_once: true  # noqa run-once[task]
+
+    - name: "Create folders."
+      folder:
+        server_url: "{{ checkmk_var_server_url }}"
+        site: "{{ checkmk_var_site }}"
+        automation_user: "{{ checkmk_var_automation_user }}"
+        automation_secret: "{{ checkmk_var_automation_secret }}"
+        path: "{{ item.path }}"
+        name: "{{ item.name }}"
+        state: "present"
+      delegate_to: localhost
+      run_once: true  # noqa run-once[task]
+      loop: "{{ checkmk_var_folders }}"
+
+    - name: "Create hosts."
+      host:
+        server_url: "{{ checkmk_var_server_url }}"
+        site: "{{ checkmk_var_site }}"
+        automation_user: "{{ checkmk_var_automation_user }}"
+        automation_secret: "{{ checkmk_var_automation_secret }}"
+        name: "{{ inventory_hostname }}"
+        folder: "{{ checkmk_var_folder_path }}"
+        attributes:
+          site: "{{ checkmk_var_site }}"
+          ipaddress: 127.0.0.1
+        state: "present"
+      delegate_to: localhost
+
+    - name: "Create DCD Configuration."
+      dcd:
+        server_url: "{{ checkmk_var_server_url }}"
+        site: "{{ checkmk_var_site }}"
+        automation_user: "{{ checkmk_var_automation_user }}"
+        automation_secret: "{{ checkmk_var_automation_secret }}"
+        dcd_config: "{{ item }}"
+        state: "present"
+      loop: "{{ checkmk_var_dcd }}"
+      run_once: true  # noqa run-once[task]
+      delegate_to: localhost
+
+    - name: "Pause to review changes."  # noqa name[unique]
+      ansible.builtin.pause:
+        prompt: |
+          "Feel free to review the changes in your Checkmk site: {{ checkmk_var_site }}."
+          "Press <Enter> to continue."
+      when: not checkmk_var_run_unattended | bool
+
+    - name: "Activate changes on site."  # noqa name[unique]
+      activation:
+        server_url: "{{ checkmk_var_server_url }}"
+        site: "{{ checkmk_var_site }}"
+        automation_user: "{{ checkmk_var_automation_user }}"
+        automation_secret: "{{ checkmk_var_automation_secret }}"
+        force_foreign_changes: 'true'
+        sites:
+          - "{{ checkmk_var_site }}"
+      delegate_to: localhost
+      run_once: true  # noqa run-once[task]
+
+    - name: "Delete DCD Configuration."
+      dcd:
+        server_url: "{{ checkmk_var_server_url }}"
+        site: "{{ checkmk_var_site }}"
+        automation_user: "{{ checkmk_var_automation_user }}"
+        automation_secret: "{{ checkmk_var_automation_secret }}"
+        dcd_config: "{{ item }}"
+        state: "absent"
+      loop: "{{ checkmk_var_dcd }}"
+      run_once: true  # noqa run-once[task]
+      delegate_to: localhost
+
+    - name: "Delete Hosts."
+      host:
+        server_url: "{{ checkmk_var_server_url }}"
+        site: "{{ checkmk_var_site }}"
+        automation_user: "{{ checkmk_var_automation_user }}"
+        automation_secret: "{{ checkmk_var_automation_secret }}"
+        name: "{{ inventory_hostname }}"
+        folder: "{{ checkmk_var_folder_path }}"
+        state: "absent"
+      delegate_to: localhost
+
+    - name: "Delete folders."
+      folder:
+        server_url: "{{ checkmk_var_server_url }}"
+        site: "{{ checkmk_var_site }}"
+        automation_user: "{{ checkmk_var_automation_user }}"
+        automation_secret: "{{ checkmk_var_automation_secret }}"
+        path: "{{ item.path }}"
+        name: "{{ item.name }}"
+        state: "absent"
+      delegate_to: localhost
+      run_once: true  # noqa run-once[task]
+      loop: "{{ checkmk_var_folders }}"
+
+    - name: "Pause to review changes."  # noqa name[unique]
+      ansible.builtin.pause:
+        prompt: |
+          "Feel free to review the changes in your Checkmk site: {{ checkmk_var_site }}."
+          "Press <Enter> to continue."
+      when: not checkmk_var_run_unattended | bool
+
+    - name: "Activate changes on site."  # noqa name[unique]
+      activation:
+        server_url: "{{ checkmk_var_server_url }}"
+        site: "{{ checkmk_var_site }}"
+        automation_user: "{{ checkmk_var_automation_user }}"
+        automation_secret: "{{ checkmk_var_automation_secret }}"
+        force_foreign_changes: 'true'
+        sites:
+          - "{{ checkmk_var_site }}"
+      delegate_to: localhost
+      run_once: true  # noqa run-once[task]

playbooks/vars/dcd.yml

@@ -0,0 +1,20 @@
+---
+checkmk_var_dcd:
+
+  - title: "vSphere"
+    dcd_id: "vsphere"
+    comment: "Main vSphere Connector"
+    # site: "mysite"
+    connector:
+      connector_type: "piggyback"
+      interval: 60
+      creation_rules:
+        - folder_path: "/"
+          delete_hosts: false
+          host_attributes:
+            tag_address_family: "no-ip"
+            tag_agent: "special-agents"
+            tag_piggyback: "piggyback"
+            tag_snmp_ds: "no-snmp"
+      discover_on_creation: true
+      restrict_source_hosts: "localhost"