create controller_managed_device_groups

plugins/module_utils/dcim.py

@@ -18,6 +18,7 @@
 NB_CONSOLE_SERVER_PORTS = "console_server_ports"
 NB_CONSOLE_SERVER_PORT_TEMPLATES = "console_server_port_templates"
 NB_CONTROLLERS = "controllers"
+NB_CONTROLLER_MANAGED_DEVICE_GROUPS = "controller_managed_device_groups"
 NB_DEVICE_BAYS = "device_bays"
 NB_DEVICE_BAY_TEMPLATES = "device_bay_templates"
 NB_DEVICE_REDUNDANCY_GROUPS = "device_redundancy_groups"
@@ -59,6 +60,7 @@ def run(self):
         - console_server_ports
         - console_server_port_templates
         - controllers
+        - controller_managed_device_groups
         - device_bays
         - device_bay_templates
         - devices

plugins/module_utils/utils.py

@@ -40,6 +40,7 @@
         "console_server_ports",
         "console_server_port_templates",
         "controllers",
+        "controller_managed_device_groups",
         "device_bays",
         "device_bay_templates",
         "devices",
@@ -105,6 +106,7 @@
     cluster_group="name",
     cluster_type="name",
     controller="name",
+    controller_managed_device_group="name",
     device="name",
     role="name",
     device_type="model",
@@ -238,6 +240,7 @@
     "console_server_port_templates": "console_server_port_template",
     "contacts": "contact",
     "controllers": "controller",
+    "controller_managed_device_groups": "controller_managed_device_group",
     "custom_fields": "custom_field",
     "custom_field_choices": "custom_field_choice",
     "device_bays": "device_bay",
@@ -306,6 +309,7 @@
     "contact": set(["name", "phone", "email"]),
     "contacts": set(["name", "phone", "email"]),
     "controller": set(["name"]),
+    "controller_managed_device_group": set(["name"]),
     "custom_field": set(["label"]),
     "custom_field_choice": set(["value", "custom_field"]),
     "dcim.consoleport": set(["name", "device"]),

plugins/modules/controller_managed_device_group.py

@@ -0,0 +1,126 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+# Copyright: (c) 2024, Network to Code (@networktocode) <[email protected]>
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+from __future__ import absolute_import, division, print_function
+
+__metaclass__ = type
+
+DOCUMENTATION = r"""
+---
+module: controller_managed_device_group
+short_description: Create, update or delete managed device groups within Nautobot
+description:
+  - Creates, updates or removes managed device groups from Nautobot.
+notes:
+  - Tags should be defined as a YAML list
+  - This should be ran with connection C(local) and hosts C(localhost)
+author:
+  - Sven Winkelmann (@pugnacity)
+version_added: "5.4.0"
+extends_documentation_fragment:
+  - networktocode.nautobot.fragments.base
+  - networktocode.nautobot.fragments.tags
+  - networktocode.nautobot.fragments.custom_fields
+options:
+  name:
+    description:
+      - The name of the controller managed device groups
+    required: true
+    type: str
+  controller:
+    description:
+      - The name of the controller for this group
+    required: true
+    type: str
+  weight:
+    description:
+      - weight of the managed device group
+    required: false
+    type: int
+  parent:
+    description:
+      - parent group of the managed device group
+    required: false
+    type: str
+  devices:
+    description:
+      - devices which should be assigend to this group
+    type: list
+    elements: str
+"""
+
+EXAMPLES = r"""
+- name: "Test Nautobot modules"
+  connection: local
+  hosts: localhost
+  gather_facts: False
+
+  tasks:
+    - name: Create controller within Nautobot with only required information
+      networktocode.nautobot.controller_managed_device_group:
+        url: http://nautobot.local
+        token: thisIsMyToken
+        name: "group_1"
+        controller: my_controller
+        state: present
+
+    - name: Delete controller within nautobot
+      networktocode.nautobot.controller:
+        url: http://nautobot.local
+        token: thisIsMyToken
+        name: test_controller_group_3
+        state: absent
+
+"""
+
+RETURN = r"""
+controller_managed_device_group:
+  description: Serialized object as created or already existent within Nautobot
+  returned: success (when I(state=present))
+  type: dict
+msg:
+  description: Message indicating failure or info about what has been achieved
+  returned: always
+  type: str
+"""
+
+from ansible_collections.networktocode.nautobot.plugins.module_utils.utils import (
+    NAUTOBOT_ARG_SPEC,
+    TAGS_ARG_SPEC,
+    CUSTOM_FIELDS_ARG_SPEC,
+)
+from ansible_collections.networktocode.nautobot.plugins.module_utils.dcim import (
+    NautobotDcimModule,
+    NB_CONTROLLER_MANAGED_DEVICE_GROUPS,
+)
+from ansible.module_utils.basic import AnsibleModule
+from copy import deepcopy
+
+
+def main():
+    """
+    Main entry point for module execution
+    """
+    argument_spec = deepcopy(NAUTOBOT_ARG_SPEC)
+    argument_spec.update(deepcopy(TAGS_ARG_SPEC))
+    argument_spec.update(deepcopy(CUSTOM_FIELDS_ARG_SPEC))
+    argument_spec.update(
+        dict(
+            name=dict(required=True, type="str"),
+            controller=dict(required=True, type="str"),
+            weight=dict(required=False, type="int"),
+            devices=dict(required=False, type="list", elements="str"),
+            parent=dict(required=False, type="str"),
+        )
+    )
+
+    module = AnsibleModule(argument_spec=argument_spec, supports_check_mode=True)
+
+    controller = NautobotDcimModule(module, NB_CONTROLLER_MANAGED_DEVICE_GROUPS)
+    controller.run()
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

plugins/modules/device.py

@@ -158,6 +158,12 @@
     required: false
     type: raw
     version_added: "5.1.0"
+  controller_managed_device_group:
+    description:
+      - Device controller_managed_device_group the device will be assigned to
+    required: false
+    type: raw
+    version_added: "5.4.0"
   device_redundancy_group_priority:
     description:
       - Priority in the assigned device redundancy group
@@ -290,6 +296,7 @@ def main():
             vc_priority=dict(required=False, type="int"),
             comments=dict(required=False, type="str"),
             local_config_context_data=dict(required=False, type="dict"),
+            controller_managed_device_group=dict(required=False, type="raw"),
             device_redundancy_group=dict(required=False, type="raw"),
             device_redundancy_group_priority=dict(required=False, type="int"),
         )

tasks.py

@@ -32,9 +32,9 @@ def is_truthy(arg):
 namespace.configure(
     {
         "nautobot_ansible": {
-            "nautobot_ver": "2.0.0",
+            "nautobot_ver": "2.3.5",
             "project_name": "nautobot_ansible",
-            "python_ver": "3.10",
+            "python_ver": "3.11",
             "local": False,
             "compose_dir": os.path.join(os.path.dirname(__file__), "development"),
             "compose_files": ["docker-compose.yml"],

tests/integration/targets/latest/tasks/controller_managed_device_groups.yml

@@ -0,0 +1,36 @@
+---
+- debug:
+    msg: "{{ nautobot_version }}"
+
+- block:
+  - set_fact:
+      parent_location: "{{ lookup('networktocode.nautobot.lookup', 'locations', api_endpoint=nautobot_url, token=nautobot_token, api_filter='name=\"Parent Test Location\"') }}"
+
+  - name: "CONTROLLER 1: Necessary info creation"
+    networktocode.nautobot.controller:
+      url: "{{ nautobot_url }}"
+      token: "{{ nautobot_token }}"
+      name: Test Controller One
+      location: "Parent Test Location"
+      state: present
+      status: "Active"
+    register: test_one_controller
+
+  - name: "CONTROLLER 2: Create Group"
+    networktocode.nautobot.controller_managed_device_groups:
+      url: "{{ nautobot_url }}"
+      token: "{{ nautobot_token }}"
+      name: Test Controller Group One
+      controller: Test Controller One
+      state: present
+    register: test_two
+
+  - name: "CONTROLLER 2: ASSERT - Create Group"
+    assert:
+      that:
+        - test_two['changed']
+        - test_two['controller_managed_device_group']['name'] == "Test Controller Group One"
+
+  when:
+    # Controllers are only available on Nautobot 2.2+
+    - "nautobot_version is version('2.2', '>=')"