Merge pull request #971 from netbox-community/devel

Release 3.12.0

Author: rodvand

CHANGELOG.rst

@@ -5,6 +5,46 @@ NetBox.NetBox Release Notes
 .. contents:: Topics
 
 
+v3.12.0
+=======
+
+Minor Changes
+-------------
+
+- netbox_aggregate - Add tenant as parameter to module [#968](https://github.com/netbox-community/ansible_modules/pull/968)
+- netbox_asn - Add module [#947](https://github.com/netbox-community/ansible_modules/pull/947)
+- netbox_fhrp_group - Add module [#957](https://github.com/netbox-community/ansible_modules/pull/957)
+- netbox_journal_entry - Add module [#961](https://github.com/netbox-community/ansible_modules/pull/961)
+
+Bugfixes
+--------
+
+- Fix partial updates of custom_fields [#944](https://github.com/netbox-community/ansible_modules/pull/944)
+- nb_inventory - Fix nb_inventory group_by by site_group [#952](https://github.com/netbox-community/ansible_modules/pull/952)
+- netbox_location - Add multiple filter options to make sure we find the unique location [#963](https://github.com/netbox-community/ansible_modules/pull/963)
+
+New Modules
+-----------
+
+- netbox.netbox.netbox_asn - Create, update or delete ASN in NetBox
+- netbox.netbox.netbox_fhrp_group - Create, update or delete FHRP groups in NetBox
+- netbox.netbox.netbox_journal_entry - Create journal entries in NetBox
+
+v3.11.0
+=======
+
+Minor Changes
+-------------
+
+- nb_inventory - Add serial and asset tag to extracted attributes [#826](https://github.com/netbox-community/ansible_modules/pull/826)
+
+Bugfixes
+--------
+
+- nb_lookup - Fix pynetbox 7.0.1 compatibility [#934](https://github.com/netbox-community/ansible_modules/pull/934)
+- netbox_cable - Fix NetBox 3.3 compatibility [#938](https://github.com/netbox-community/ansible_modules/pull/938)
+- netbox_webhook - Fix conditions bug [#926](https://github.com/netbox-community/ansible_modules/pull/926)
+
 v3.10.0
 =======
 

README.md

@@ -11,13 +11,13 @@ To keep the code simple, we only officially support the two latest releases of N
 
 ## Requirements
 
-- NetBox 2.11+ or the two latest NetBox releases
+- The two latest NetBox releases
 - Python 3.8+
 - Python modules:
   - `pytz`
-  - `pynetbox 5.0.4+`, `pynetbox 6.4.0+` if using 3.1 features
+  - `pynetbox`
   - `packaging` if using Ansible < 2.10, as it's included in Ansible 2.10+
-- Ansible 2.10+
+- Ansible 2.12+
 - NetBox write-enabled token when using modules or read-only token for `nb_lookup/nb_inventory`
 
 ## Docs

changelogs/changelog.yaml

@@ -765,4 +765,26 @@ releases:
         - nb_lookup - Fix pynetbox 7.0.1 compatibility [#934](https://github.com/netbox-community/ansible_modules/pull/934)
       minor_changes:
         - nb_inventory - Add serial and asset tag to extracted attributes [#826](https://github.com/netbox-community/ansible_modules/pull/826) 
-    release_date: '2023-02-12' 
+    release_date: '2023-02-12' 
+  3.12.0:
+    changes:
+      bugfixes:
+        - nb_inventory - Fix nb_inventory group_by by site_group [#952](https://github.com/netbox-community/ansible_modules/pull/952)
+        - netbox_location - Add multiple filter options to make sure we find the unique location [#963](https://github.com/netbox-community/ansible_modules/pull/963)
+        - Fix partial updates of custom_fields [#944](https://github.com/netbox-community/ansible_modules/pull/944)
+      minor_changes:
+        - netbox_asn - Add module [#947](https://github.com/netbox-community/ansible_modules/pull/947)
+        - netbox_journal_entry - Add module [#961](https://github.com/netbox-community/ansible_modules/pull/961)
+        - netbox_fhrp_group - Add module [#957](https://github.com/netbox-community/ansible_modules/pull/957)
+        - netbox_aggregate - Add tenant as parameter to module [#968](https://github.com/netbox-community/ansible_modules/pull/968)
+    modules:
+      - description: Create journal entries in NetBox
+        name: netbox_journal_entry
+        namespace: ''
+      - description: Create, update or delete FHRP groups in NetBox
+        name: netbox_fhrp_group
+        namespace: ''
+      - description: Create, update or delete ASN in NetBox
+        name: netbox_asn
+        namespace: ''
+    release_date: '2023-04-04'

changelogs/fragments/issue-951.yml

@@ -0,0 +1,3 @@
+---
+bugfixes:
+  - Fix nb_inventory group_by by site_group (#951)

docs/conf.py

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

docs/plugins/index.rst

@@ -6,7 +6,7 @@
 Netbox.Netbox
 =============
 
-Collection version 3.8.1
+Collection version 3.12.0
 
 .. contents::
    :local:
@@ -49,6 +49,7 @@ Modules
 ~~~~~~~
 
 * :ref:`netbox_aggregate module <ansible_collections.netbox.netbox.netbox_aggregate_module>` -- Creates or removes aggregates from NetBox
+* :ref:`netbox_asn module <ansible_collections.netbox.netbox.netbox_asn_module>` -- Create, update or delete ASNs within NetBox
 * :ref:`netbox_cable module <ansible_collections.netbox.netbox.netbox_cable_module>` -- Create, update or delete cables within NetBox
 * :ref:`netbox_circuit module <ansible_collections.netbox.netbox.netbox_circuit_module>` -- Create, update or delete circuits within NetBox
 * :ref:`netbox_circuit_termination module <ansible_collections.netbox.netbox.netbox_circuit_termination_module>` -- Create, update or delete circuit terminations within NetBox
@@ -74,12 +75,14 @@ Modules
 * :ref:`netbox_device_role module <ansible_collections.netbox.netbox.netbox_device_role_module>` -- Create, update or delete devices roles within NetBox
 * :ref:`netbox_device_type module <ansible_collections.netbox.netbox.netbox_device_type_module>` -- Create, update or delete device types within NetBox
 * :ref:`netbox_export_template module <ansible_collections.netbox.netbox.netbox_export_template_module>` -- Creates, updates or deletes export templates within NetBox
+* :ref:`netbox_fhrp_group module <ansible_collections.netbox.netbox.netbox_fhrp_group_module>` -- Create, update or delete FHRP groups within NetBox
 * :ref:`netbox_front_port module <ansible_collections.netbox.netbox.netbox_front_port_module>` -- Create, update or delete front ports within NetBox
 * :ref:`netbox_front_port_template module <ansible_collections.netbox.netbox.netbox_front_port_template_module>` -- Create, update or delete front port templates within NetBox
 * :ref:`netbox_inventory_item module <ansible_collections.netbox.netbox.netbox_inventory_item_module>` -- Creates or removes inventory items from NetBox
 * :ref:`netbox_inventory_item_role module <ansible_collections.netbox.netbox.netbox_inventory_item_role_module>` -- Create, update or delete devices roles within 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_journal_entry module <ansible_collections.netbox.netbox.netbox_journal_entry_module>` -- Creates a journal entry
 * :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
@@ -141,6 +144,7 @@ Lookup Plugins
     nb_inventory_inventory
     nb_lookup_lookup
     netbox_aggregate_module
+    netbox_asn_module
     netbox_cable_module
     netbox_circuit_module
     netbox_circuit_termination_module
@@ -166,12 +170,14 @@ Lookup Plugins
     netbox_device_role_module
     netbox_device_type_module
     netbox_export_template_module
+    netbox_fhrp_group_module
     netbox_front_port_module
     netbox_front_port_template_module
     netbox_inventory_item_module
     netbox_inventory_item_role_module
     netbox_ip_address_module
     netbox_ipam_role_module
+    netbox_journal_entry_module
     netbox_l2vpn_module
     netbox_location_module
     netbox_manufacturer_module

docs/plugins/nb_inventory_inventory.rst

@@ -42,7 +42,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.12.0).
 
     To install it, use: :code:`ansible-galaxy collection install netbox.netbox`.
 

docs/plugins/nb_lookup_lookup.rst

@@ -42,7 +42,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.12.0).
 
     To install it, use: :code:`ansible-galaxy collection install netbox.netbox`.
     You need further requirements to be able to use this lookup plugin,
@@ -534,24 +534,6 @@ Examples
                         api_filter='role=management tag=Dell'),
                         token='<redacted>') }}"
 
-    # Obtain a secret for R1-device
-    tasks:
-      - name: "Obtain secrets for R1-Device"
-        debug:
-          msg: "{{ query('netbox.netbox.nb_lookup', 'secrets', api_filter='device=R1-Device', api_endpoint='http://localhost/', token='<redacted>', key_file='~/.ssh/id_rsa') }}"
-
-    # Fetch bgp sessions for R1-device
-    tasks:
-      - name: "Obtain bgp sessions for R1-Device"
-        debug:
-          msg: "{{ query('netbox.netbox.nb_lookup', 'bgp_sessions',
-                         api_filter='device=R1-Device',
-                         api_endpoint='http://localhost/',
-                         token='<redacted>',
-                         plugin='mycustomstuff') }}"
-
-          msg: "{{ query('netbox.netbox.nb_lookup', 'secrets', api_filter='device=R1-Device', api_endpoint='http://localhost/', token='<redacted>', key_file='~/.ssh/id_rsa') }}"
-
 
 
 

docs/plugins/netbox_aggregate_module.rst

@@ -42,7 +42,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.12.0).
 
     To install it, use: :code:`ansible-galaxy collection install netbox.netbox`.
     You need further requirements to be able to use this module,
@@ -410,6 +410,43 @@ Parameters
       Any tags that the aggregate may need to be associated with
 
 
+      .. raw:: html
+
+        </div>
+
+  * - .. raw:: html
+
+        <div class="ansible-option-indent"></div><div class="ansible-option-cell">
+        <div class="ansibleOptionAnchor" id="parameter-data/tenant"></div>
+
+      .. _ansible_collections.netbox.netbox.netbox_aggregate_module__parameter-data/tenant:
+
+      .. rst-class:: ansible-option-title
+
+      **tenant**
+
+      .. raw:: html
+
+        <a class="ansibleOptionLink" href="#parameter-data/tenant" title="Permalink to this option"></a>
+
+      .. rst-class:: ansible-option-type-line
+
+      :ansible-option-type:`any`
+
+      :ansible-option-versionadded:`added in netbox.netbox 3.12.0`
+
+
+      .. raw:: html
+
+        </div>
+
+    - .. raw:: html
+
+        <div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">
+
+      Tenant the aggregate will be assigned to.
+
+
       .. raw:: html
 
         </div>