Merge pull request #874 from netbox-community/devel

Release 3.9.0

Author: rodvand

CHANGELOG.rst

@@ -5,6 +5,29 @@ NetBox.NetBox Release Notes
 .. contents:: Topics
 
 
+v3.9.0
+======
+
+Minor Changes
+-------------
+
+- nb_lookup - Add 3.3 endpoints for lookup [#865](https://github.com/netbox-community/ansible_modules/pull/865)
+- netbox_console_server and netbox_console_server_port - Add new field [#866](https://github.com/netbox-community/ansible_modules/pull/866)
+- netbox_device_bay - Add label [#868](https://github.com/netbox-community/ansible_modules/pull/868)
+- netbox_l2vpn - Add module [#846](https://github.com/netbox-community/ansible_modules/pull/846)
+
+Bugfixes
+--------
+
+- nb_inventory - Fix site_group in inventory plugin [#872](https://github.com/netbox-community/ansible_modules/pull/872)
+- nb_inventory - Make sure inventory works with ansible < 2.11 [#861](https://github.com/netbox-community/ansible_modules/pull/861)
+- netbox_virtual_machine - Fix idempotency with virtual machine and NetBox 3.0 [#859](https://github.com/netbox-community/ansible_modules/pull/859)
+
+New Modules
+-----------
+
+- netbox.netbox.netbox_l2vpn - Create, update or delete L2VPN objects in NetBox
+
 v3.8.1
 ======
 

changelogs/changelog.yaml

@@ -716,3 +716,19 @@ releases:
         - Update CI to include NetBox 3.3 [#841](https://github.com/netbox-community/ansible_modules/pull/841)
         - Update documentation to show exclusion filter [#837](https://github.com/netbox-community/ansible_modules/pull/837)
     release_date: '2022-10-17'
+  3.9.0:
+    changes:
+      bugfixes:
+        - netbox_virtual_machine - Fix idempotency with virtual machine and NetBox 3.0 [#859](https://github.com/netbox-community/ansible_modules/pull/859)
+        - nb_inventory - Make sure inventory works with ansible < 2.11 [#861](https://github.com/netbox-community/ansible_modules/pull/861)
+        - nb_inventory - Fix site_group in inventory plugin [#872](https://github.com/netbox-community/ansible_modules/pull/872)
+      minor_changes:
+        - netbox_l2vpn - Add module [#846](https://github.com/netbox-community/ansible_modules/pull/846)
+        - nb_lookup - Add 3.3 endpoints for lookup [#865](https://github.com/netbox-community/ansible_modules/pull/865)
+        - netbox_device_bay - Add label [#868](https://github.com/netbox-community/ansible_modules/pull/868)
+        - netbox_console_server and netbox_console_server_port - Add new field [#866](https://github.com/netbox-community/ansible_modules/pull/866)        
+    modules:
+      - description: Create, update or delete L2VPN objects in NetBox 
+        name: netbox_l2vpn
+        namespace: ''
+    release_date: '2022-11-14'

docs/conf.py

@@ -15,7 +15,7 @@
 import re
 import stat
 from pathlib import Path
-from antsibull.cli import antsibull_docs
+from antsibull_docs.cli import antsibull_docs
 
 sys.path.insert(0, os.path.abspath("../"))
 
@@ -27,7 +27,7 @@
 author = "Mikhail Yohman <@FragmentedPacket>"
 
 # The full version, including alpha/beta/rc tags
-release = "3.8.1"
+release = "3.9.0"
 
 
 # -- General configuration ---------------------------------------------------

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

@@ -221,3 +221,36 @@ that specify fields that are unique to each tag. Name can be used, but we always
           state: "present"
 
 .. warning:: Everything discussed above can be applied to each module, but may need to swap out any arguments for module specific arguments.
+
+Using module default groups
++++++++++++++++++++++++++++++
+
+To avoid having to define the ``netbox_url`` and ``netbox_token`` in each task you can use the module default group feature. 
+
+.. code-block:: yaml
+
+  ---
+  ...
+    module_defaults:
+      group/netbox.netbox.netbox:
+        netbox_url: "http://netbox.local"
+        netbox_token: "thisIsMyToken"
+    tasks:
+      - name: "Example using tags"
+        netbox.netbox.netbox_device:
+          data:
+            name: "Test Device"
+            tags:
+              - slug: "my-new-tag1"
+              - slug: "my-new-tag2"
+          state: "present"
+
+      - name: "Example state: present - Update"
+        netbox.netbox.netbox_device:          
+          data:
+            name: "Test Device"
+            serial: "FXS110011"
+          state: "present"
+
+.. note::
+  Module default groups are available from Ansible 2.12.

docs/plugins/index.rst

@@ -6,7 +6,7 @@
 Netbox.Netbox
 =============
 
-Collection version 3.8.1
+Collection version 3.9.0
 
 .. contents::
    :local:
@@ -75,6 +75,7 @@ Modules
 * :ref:`netbox_inventory_item module <ansible_collections.netbox.netbox.netbox_inventory_item_module>` -- Creates or removes inventory items from NetBox
 * :ref:`netbox_ip_address module <ansible_collections.netbox.netbox.netbox_ip_address_module>` -- Creates or removes IP addresses from NetBox
 * :ref:`netbox_ipam_role module <ansible_collections.netbox.netbox.netbox_ipam_role_module>` -- Creates or removes ipam roles from NetBox
+* :ref:`netbox_l2vpn module <ansible_collections.netbox.netbox.netbox_l2vpn_module>` -- Create, update or delete L2VPNs within NetBox
 * :ref:`netbox_location module <ansible_collections.netbox.netbox.netbox_location_module>` -- Create, update or delete locations within NetBox
 * :ref:`netbox_manufacturer module <ansible_collections.netbox.netbox.netbox_manufacturer_module>` -- Create or delete manufacturers within NetBox
 * :ref:`netbox_platform module <ansible_collections.netbox.netbox.netbox_platform_module>` -- Create or delete platforms within NetBox
@@ -167,6 +168,7 @@ Lookup Plugins
     netbox_inventory_item_module
     netbox_ip_address_module
     netbox_ipam_role_module
+    netbox_l2vpn_module
     netbox_location_module
     netbox_manufacturer_module
     netbox_platform_module

docs/plugins/nb_inventory_inventory.rst

@@ -43,7 +43,7 @@ netbox.netbox.nb_inventory inventory -- NetBox inventory source
 .. Collection note
 
 .. note::
-    This inventory plugin is part of the `netbox.netbox collection <https://galaxy.ansible.com/netbox/netbox>`_ (version 3.8.1).
+    This inventory plugin is part of the `netbox.netbox collection <https://galaxy.ansible.com/netbox/netbox>`_ (version 3.9.0).
 
     To install it, use: :code:`ansible-galaxy collection install netbox.netbox`.
 

docs/plugins/nb_lookup_lookup.rst

@@ -43,7 +43,7 @@ netbox.netbox.nb_lookup lookup -- Queries and returns elements from NetBox
 .. Collection note
 
 .. note::
-    This lookup plugin is part of the `netbox.netbox collection <https://galaxy.ansible.com/netbox/netbox>`_ (version 3.8.1).
+    This lookup plugin is part of the `netbox.netbox collection <https://galaxy.ansible.com/netbox/netbox>`_ (version 3.9.0).
 
     To install it, use: :code:`ansible-galaxy collection install netbox.netbox`.
     You need further requirements to be able to use this lookup plugin,

docs/plugins/netbox_aggregate_module.rst

@@ -43,7 +43,7 @@ netbox.netbox.netbox_aggregate module -- Creates or removes aggregates from NetB
 .. Collection note
 
 .. note::
-    This module is part of the `netbox.netbox collection <https://galaxy.ansible.com/netbox/netbox>`_ (version 3.8.1).
+    This module is part of the `netbox.netbox collection <https://galaxy.ansible.com/netbox/netbox>`_ (version 3.9.0).
 
     To install it, use: :code:`ansible-galaxy collection install netbox.netbox`.
     You need further requirements to be able to use this module,

docs/plugins/netbox_cable_module.rst

@@ -43,7 +43,7 @@ netbox.netbox.netbox_cable module -- Create, update or delete cables within NetB
 .. Collection note
 
 .. note::
-    This module is part of the `netbox.netbox collection <https://galaxy.ansible.com/netbox/netbox>`_ (version 3.8.1).
+    This module is part of the `netbox.netbox collection <https://galaxy.ansible.com/netbox/netbox>`_ (version 3.9.0).
 
     To install it, use: :code:`ansible-galaxy collection install netbox.netbox`.
     You need further requirements to be able to use this module,

docs/plugins/netbox_circuit_module.rst

@@ -43,7 +43,7 @@ netbox.netbox.netbox_circuit module -- Create, update or delete circuits within
 .. Collection note
 
 .. note::
-    This module is part of the `netbox.netbox collection <https://galaxy.ansible.com/netbox/netbox>`_ (version 3.8.1).
+    This module is part of the `netbox.netbox collection <https://galaxy.ansible.com/netbox/netbox>`_ (version 3.9.0).
 
     To install it, use: :code:`ansible-galaxy collection install netbox.netbox`.
     You need further requirements to be able to use this module,