Merge pull request #831 from netbox-community/devel

Release 3.8.0

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -2,7 +2,7 @@
 name: ✨ Feature Request
 description: Propose a new NetBox Ansible modules feature or enhancement
 title: "[Feature]: "
-labels: ["enhancement"]
+labels: ["Enhancement"]
 body:
   - type: markdown
     attributes:

CHANGELOG.rst

@@ -5,6 +5,20 @@ NetBox.NetBox Release Notes
 .. contents:: Topics
 
 
+v3.8.0
+======
+
+Minor Changes
+-------------
+
+- Add action_group to enable module defaults groups [#800](https://github.com/netbox-community/ansible_modules/pull/800)
+- Expand on query_filter for site [#824](https://github.com/netbox-community/ansible_modules/pull/824)
+- nb_inventory - Allow API token to be templated [#806](https://github.com/netbox-community/ansible_modules/pull/806)
+- netbox_cable - Change length to float from int [#828](https://github.com/netbox-community/ansible_modules/pull/828)
+- netbox_device_interface - Add PoE attribute [#820](https://github.com/netbox-community/ansible_modules/pull/820)
+- netbox_location - Add tenant to module [#829](https://github.com/netbox-community/ansible_modules/pull/829)
+- netbox_prefix - Add mark_utilized to module [#827](https://github.com/netbox-community/ansible_modules/pull/827)
+
 v3.7.1
 ======
 

changelogs/changelog.yaml

@@ -695,3 +695,14 @@ releases:
         - nb_inventory - Fix netbox_inventory site_group group_by @ryanmerolle in [#780](https://github.com/netbox-community/ansible_modules/pull/780)
         - nb_inventory - Ensure inventory works on NetBox versions without the site group model [#781](https://github.com/netbox-community/ansible_modules/pull/781)
     release_date: '2022-04-26'
+  3.8.0:
+    changes:
+      minor_changes:
+        - Add action_group to enable module defaults groups [#800](https://github.com/netbox-community/ansible_modules/pull/800)
+        - netbox_device_interface - Add PoE attribute [#820](https://github.com/netbox-community/ansible_modules/pull/820)
+        - Expand on query_filter for site [#824](https://github.com/netbox-community/ansible_modules/pull/824)
+        - nb_inventory - Allow API token to be templated [#806](https://github.com/netbox-community/ansible_modules/pull/806)
+        - netbox_prefix - Add mark_utilized to module [#827](https://github.com/netbox-community/ansible_modules/pull/827)
+        - netbox_cable - Change length to float from int [#828](https://github.com/netbox-community/ansible_modules/pull/828)
+        - netbox_location - Add tenant to module [#829](https://github.com/netbox-community/ansible_modules/pull/829)      
+    release_date: '2022-09-19'

docs/conf.py

@@ -27,7 +27,7 @@
 author = "Mikhail Yohman <@FragmentedPacket>"
 
 # The full version, including alpha/beta/rc tags
-release = "3.7.1"
+release = "3.8.0"
 
 
 # -- General configuration ---------------------------------------------------

docs/getting_started/how-to-use/advanced.rst

@@ -298,4 +298,36 @@ IP address to be within **Test VRF 2**.
 
 We can now see that the IP address is now within VRF with ID 2.
 
-Hopefully this shines some light on this useful feature to allow you, as the user, to define your specific needs for finding a unique object within your NetBox instance.
+Hopefully this shines some light on this useful feature to allow you, as the user, to define your specific needs for finding a unique object within your NetBox instance.
+
+
+Using Module defaults groups
+--------------------------------------------
+
+Ansible-core >= 2.12 provide a useful feature called [Module defaults groups](https://docs.ansible.com/ansible/latest/user_guide/playbooks_module_defaults.html#module-defaults-groups) that lets us specify default parameters for a group of modules in a single place. We can use the action_group ``netbox`` that contains all modules from this collection to avoid setting e.g. ``token`` and ``url`` on each task and thus reduce boilerplate code.
+
+.. code-block:: yaml
+
+   ---
+   - hosts: "localhost"
+
+     module_defaults:
+       group/netbox.netbox.netbox:
+         netbox_url: "http://netbox.local"
+         netbox_token: "thisIsMyToken"
+
+     tasks:
+       - name: "Create device type"
+         netbox.netbox.netbox_device_type:
+           data:
+             model: "test-device-type"
+             slug: "c9410r"
+
+       - name: "Create device"
+         netbox.netbox.netbox_device:
+           data:
+             name: "Test Device"
+             device_type: "C9410R"
+             device_role: "Core Switch"
+             site: "Main"
+

docs/plugins/index.rst

@@ -1,11 +1,12 @@
 
 
+
 .. _plugins_in_netbox.netbox:
 
 Netbox.Netbox
 =============
 
-Collection version 3.7.1
+Collection version 3.8.0
 
 .. contents::
    :local:
@@ -101,7 +102,7 @@ Modules
 * :ref:`netbox_tenant module <ansible_collections.netbox.netbox.netbox_tenant_module>` -- Creates or removes tenants from NetBox
 * :ref:`netbox_tenant_group module <ansible_collections.netbox.netbox.netbox_tenant_group_module>` -- Creates or removes tenant groups from NetBox
 * :ref:`netbox_virtual_chassis module <ansible_collections.netbox.netbox.netbox_virtual_chassis_module>` -- Create, update or delete virtual chassis within NetBox
-* :ref:`netbox_virtual_machine module <ansible_collections.netbox.netbox.netbox_virtual_machine_module>` -- Create, update or delete virtual_machines within NetBox
+* :ref:`netbox_virtual_machine module <ansible_collections.netbox.netbox.netbox_virtual_machine_module>` -- Create, update or delete virtual\_machines within NetBox
 * :ref:`netbox_vlan module <ansible_collections.netbox.netbox.netbox_vlan_module>` -- Create, update or delete vlans within NetBox
 * :ref:`netbox_vlan_group module <ansible_collections.netbox.netbox.netbox_vlan_group_module>` -- Create, update or delete vlans groups within NetBox
 * :ref:`netbox_vm_interface module <ansible_collections.netbox.netbox.netbox_vm_interface_module>` -- Creates or removes interfaces from virtual machines in NetBox