Merge branch 'main' into vrf_af

.pre-commit-config.yaml

@@ -7,7 +7,7 @@ repos:
       - id: update-docs
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v5.0.0
     hooks:
       - id: check-merge-conflict
       - id: check-symlinks
@@ -22,8 +22,8 @@ repos:
     hooks:
       - id: add-trailing-comma
 
-  - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: "v4.0.0-alpha.8"
+  - repo: https://github.com/pycontribs/mirrors-prettier
+    rev: "v3.4.2"
     hooks:
       - id: prettier
         entry: env CI=1 bash -c "prettier --list-different . || ec=$? && prettier --loglevel=error --write . && exit $ec"
@@ -41,11 +41,11 @@ repos:
         args: ["--filter-files"]
 
   - repo: https://github.com/psf/black
-    rev: 24.3.0
+    rev: 24.10.0
     hooks:
       - id: black
 
   - repo: https://github.com/pycqa/flake8
-    rev: 7.0.0
+    rev: 7.1.1
     hooks:
       - id: flake8

CHANGELOG.rst

@@ -4,6 +4,91 @@ Cisco Ios Collection Release Notes
 
 .. contents:: Topics
 
+v9.0.3
+======
+
+Bugfixes
+--------
+
+- ios_bgp_address_family - fix parsing of password_options while gathering password configuration from appliance.
+- ios_bgp_global - fix parsing of password_options while gathering password configuration from appliance.
+
+Documentation Changes
+---------------------
+
+- Includes a new support related section in the README.
+- Removed the Roadmap section from the README.
+
+v9.0.2
+======
+
+Bugfixes
+--------
+
+- ios_bgp_address_family - Add support for maximum-paths configuration.
+- ios_bgp_address_family - Add support for maximum-secondary-paths configuration.
+- ios_interfaces - Fixes rendering of FiftyGigabitEthernet as it was wrongly rendering FiftyGigabitEthernet as FiveGigabitEthernet.
+- ios_snmp_server - Fixes an issue where enabling the read-only (ro) attribute in communities was not idempotent.
+- ios_static_routes - Fix processing of metric_distance as it was wrongly populated under the forward_router_address attribute.
+
+v9.0.1
+======
+
+Bugfixes
+--------
+
+- bgp_global - fix ebgp_multihop recognnition and hop_count settings
+- ios_service - Fix a typo causing log timestamps not being configurable
+- ios_vlans - Make the module fail when vlan name is longer than 32 characters with configuration as VTPv1 and VTPv2.
+- static_routes - add TenGigabitEthernet as valid interface
+
+Documentation Changes
+---------------------
+
+- ios_facts - update documentation for ansible_net_memtotal_mb, ansible_net_memfree_mb return values as mebibytes (MiB), not megabits (Mb)
+
+v9.0.0
+======
+
+Release Summary
+---------------
+
+Starting from this release, the minimum `ansible-core` version this collection requires is `2.15.0`. The last known version compatible with ansible-core<2.15 is v8.0.0.
+
+Major Changes
+-------------
+
+- Bumping `requires_ansible` to `>=2.15.0`, since previous ansible-core versions are EoL now.
+
+Minor Changes
+-------------
+
+- Add ios_vrf_global resource module in favor of ios_vrf module (fixes - https://github.com/ansible-collections/cisco.ios/pull/1055)
+
+Deprecated Features
+-------------------
+
+- ios_bgp_address_family - deprecated attribute password in favour of password_options within neigbhors.
+- ios_bgp_global - deprecated attributes aggregate_address, bestpath, inject_map, ipv4_with_subnet, ipv6_with_subnet, nopeerup_delay, distribute_list, address, tag, ipv6_addresses, password, route_map, route_server_context and scope
+- ios_linkagg - deprecate legacy module ios_linkagg
+- ios_lldp - deprecate legacy module ios_lldp
+
+Bugfixes
+--------
+
+- ios_acls - fix incorrect mapping of port 135/udp to msrpc.
+- ios_l3_interfaces - Fix gathering wrong facts for source interface in ipv4.
+- ios_service - Add tcp_small_servers and udp_small_servers attributes, to generate configuration.
+- ios_service - Fix timestamps attribute, to generate right configuration.
+- ios_static_routes - Fix gathering facts by properly distinguising routes.
+- l2_interfaces - If a large number of VLANs are affected, the configuration will now be correctly split into several commands.
+- snmp_server - Fix configuration command for snmp-server host.
+- snmp_server - Fix wrong syntax of snmp-server host command generation.
+
+Documentation Changes
+---------------------
+
+- logging_global - update documentation for severity attribute within buffered.
 
 v8.0.0
 ======
@@ -686,7 +771,7 @@ Documentation Changes
 New Modules
 -----------
 
-- ios_hostname - Resource module to configure hostname.
+- ios_hostname - hostname resource module
 
 v2.6.0
 ======
@@ -717,7 +802,7 @@ Documentation Changes
 New Modules
 -----------
 
-- ios_snmp_server - Resource module to configure snmp server.
+- ios_snmp_server - snmp_server resource module
 
 v2.5.0
 ======
@@ -750,7 +835,7 @@ Documentation Changes
 New Modules
 -----------
 
-- ios_ntp_global - Resource module to configure NTP.
+- ios_ntp_global - ntp_global resource module
 
 v2.4.0
 ======
@@ -837,8 +922,8 @@ Bugfixes
 New Modules
 -----------
 
-- ios_logging_global - Resource module to configure logging.
-- ios_prefix_lists - Resource module to configure prefix lists.
+- ios_logging_global - Logging resource module.
+- ios_prefix_lists - Prefix Lists resource module.
 
 v2.1.0
 ======
@@ -862,7 +947,7 @@ Bugfixes
 New Modules
 -----------
 
-- ios_route_maps - Resource module to configure route maps.
+- ios_route_maps - Route Maps resource module.
 
 v2.0.1
 ======
@@ -907,7 +992,7 @@ Bugfixes
 New Modules
 -----------
 
-- ios_bgp_address_family - Resource module to configure BGP Address family.
+- ios_bgp_address_family - BGP Address Family resource module.
 
 v1.3.0
 ======
@@ -930,7 +1015,7 @@ Bugfixes
 New Modules
 -----------
 
-- ios_bgp_global - Resource module to configure BGP.
+- ios_bgp_global - BGP Global resource module
 
 v1.2.1
 ======
@@ -961,7 +1046,7 @@ Bugfixes
 New Modules
 -----------
 
-- ios_ospf_interfaces - Resource module to configure OSPF interfaces.
+- ios_ospf_interfaces - OSPF Interfaces resource module
 
 v1.1.0
 ======
@@ -982,7 +1067,7 @@ Bugfixes
 New Modules
 -----------
 
-- ios_ospfv3 - Resource module to configure OSPFv3.
+- ios_ospfv3 - OSPFv3 resource module
 
 v1.0.3
 ======
@@ -1034,26 +1119,34 @@ Cliconf
 New Modules
 -----------
 
-- ios_acl_interfaces - Resource module to configure ACL interfaces.
-- ios_acls - Resource module to configure ACLs.
-- ios_banner - Module to configure multiline banners.
-- ios_command - Module to run commands on remote devices.
-- ios_config - Module to manage configuration sections.
-- ios_facts - Module to collect facts from remote devices.
-- ios_interfaces - Resource module to configure interfaces.
-- ios_l2_interfaces - Resource module to configure L2 interfaces.
-- ios_l3_interfaces - Resource module to configure L3 interfaces.
-- ios_lacp - Resource module to configure LACP.
-- ios_lacp_interfaces - Resource module to configure LACP interfaces.
-- ios_lag_interfaces - Resource module to configure LAG interfaces.
-- ios_linkagg - Module to configure link aggregation groups.
-- ios_lldp - (deprecated, removed after 2024-06-01) Manage LLDP configuration on Cisco IOS network devices.
-- ios_lldp_global - Resource module to configure LLDP.
-- ios_lldp_interfaces - Resource module to configure LLDP interfaces.
-- ios_ospfv2 - Resource module to configure OSPFv2.
-- ios_ping - Tests reachability using ping from IOS switch.
-- ios_static_routes - Resource module to configure static routes.
-- ios_system - Module to manage the system attributes.
-- ios_user - Module to manage the aggregates of local users.
-- ios_vlans - Resource module to configure VLANs.
-- ios_vrf - Module to configure VRF definitions.
+- ios_acl_interfaces - ACL interfaces resource module
+- ios_acls - ACLs resource module
+- ios_banner - Manage multiline banners on Cisco IOS devices
+- ios_bgp - Configure global BGP protocol settings on Cisco IOS.
+- ios_command - Run commands on remote devices running Cisco IOS
+- ios_config - Manage Cisco IOS configuration sections
+- ios_facts - Collect facts from remote devices running Cisco IOS
+- ios_interface - (deprecated, removed after 2022-06-01) Manage Interface on Cisco IOS network devices
+- ios_interfaces - Interfaces resource module
+- ios_l2_interface - (deprecated, removed after 2022-06-01) Manage Layer-2 interface on Cisco IOS devices.
+- ios_l2_interfaces - L2 interfaces resource module
+- ios_l3_interface - (deprecated, removed after 2022-06-01) Manage Layer-3 interfaces on Cisco IOS network devices.
+- ios_l3_interfaces - L3 interfaces resource module
+- ios_lacp - LACP resource module
+- ios_lacp_interfaces - LACP interfaces resource module
+- ios_lag_interfaces - LAG interfaces resource module
+- ios_linkagg - Manage link aggregation groups on Cisco IOS network devices
+- ios_lldp - Manage LLDP configuration on Cisco IOS network devices.
+- ios_lldp_global - LLDP resource module
+- ios_lldp_interfaces - LLDP interfaces resource module
+- ios_logging - Manage logging on network devices
+- ios_ntp - Manages core NTP configuration.
+- ios_ospfv2 - OSPFv2 resource module
+- ios_ping - Tests reachability using ping from Cisco IOS network devices
+- ios_static_route - (deprecated, removed after 2022-06-01) Manage static IP routes on Cisco IOS network devices
+- ios_static_routes - Static routes resource module
+- ios_system - Manage the system attributes on Cisco IOS devices
+- ios_user - Manage the aggregate of local users on Cisco IOS device
+- ios_vlan - (deprecated, removed after 2022-06-01) Manage VLANs on IOS network devices
+- ios_vlans - VLANs resource module
+- ios_vrf - Manage the collection of VRF definitions on Cisco IOS devices

README.md

@@ -8,10 +8,33 @@ The Ansible Cisco IOS collection includes a variety of Ansible content to help a
 
 This collection has been tested against Cisco IOS XE Version 17.3 on CML.
 
+## Support
+
+As a Red Hat Ansible [Certified Content](https://catalog.redhat.com/software/search?target_platforms=Red%20Hat%20Ansible%20Automation%20Platform), this collection is entitled to [support](https://access.redhat.com/support/) through [Ansible Automation Platform](https://www.redhat.com/en/technologies/management/ansible) (AAP).
+
+If a support case cannot be opened with Red Hat and the collection has been obtained either from [Galaxy](https://galaxy.ansible.com/ui/) or [GitHub](https://github.com/ansible-collections/cisco.ios), there is community support available at no charge.
+
+You can join us on [#network:ansible.com](https://matrix.to/#/#network:ansible.com) room or the [Ansible Forum Network Working Group](https://forum.ansible.com/g/network-wg).
+
+For more information you can check the communication section below.
+
+## Communication
+
+* Join the Ansible forum:
+  * [Get Help](https://forum.ansible.com/c/help/6): get help or help others.
+  * [Posts tagged with 'network'](https://forum.ansible.com/tag/network): subscribe to participate in collection-related conversations.
+  * [Ansible Network Automation Working Group](https://forum.ansible.com/g/network-wg/): by joining the team you will automatically get subscribed to the posts tagged with [network](https://forum.ansible.com/tags/network).
+  * [Social Spaces](https://forum.ansible.com/c/chat/4): gather and interact with fellow enthusiasts.
+  * [News & Announcements](https://forum.ansible.com/c/news/5): track project-wide announcements including social events.
+
+* The Ansible [Bullhorn newsletter](https://docs.ansible.com/ansible/devel/community/communication.html#the-bullhorn): used to announce releases and important changes.
+
+For more information about communication, see the [Ansible communication guide](https://docs.ansible.com/ansible/devel/community/communication.html).
+
 <!--start requires_ansible-->
 ## Ansible version compatibility
 
-This collection has been tested against following Ansible versions: **>=2.14.0**.
+This collection has been tested against following Ansible versions: **>=2.15.0**.
 
 For collections that support Ansible 2.9, please ensure you update your `network_os` to use the
 fully qualified collection name (for example, `cisco.ios.ios`).
@@ -52,8 +75,6 @@ Name | Description
 [cisco.ios.ios_lacp](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_lacp_module.rst)|Resource module to configure LACP.
 [cisco.ios.ios_lacp_interfaces](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_lacp_interfaces_module.rst)|Resource module to configure LACP interfaces.
 [cisco.ios.ios_lag_interfaces](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_lag_interfaces_module.rst)|Resource module to configure LAG interfaces.
-[cisco.ios.ios_linkagg](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_linkagg_module.rst)|Module to configure link aggregation groups.
-[cisco.ios.ios_lldp](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_lldp_module.rst)|(deprecated, removed after 2024-06-01) Manage LLDP configuration on Cisco IOS network devices.
 [cisco.ios.ios_lldp_global](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_lldp_global_module.rst)|Resource module to configure LLDP.
 [cisco.ios.ios_lldp_interfaces](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_lldp_interfaces_module.rst)|Resource module to configure LLDP interfaces.
 [cisco.ios.ios_logging_global](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_logging_global_module.rst)|Resource module to configure logging.
@@ -71,6 +92,8 @@ Name | Description
 [cisco.ios.ios_user](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_user_module.rst)|Module to manage the aggregates of local users.
 [cisco.ios.ios_vlans](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_vlans_module.rst)|Resource module to configure VLANs.
 [cisco.ios.ios_vrf](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_vrf_module.rst)|Module to configure VRF definitions.
+[cisco.ios.ios_vrf_global](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_vrf_global_module.rst)|Resource module to configure global VRF definitions.
+[cisco.ios.ios_vrf_interfaces](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_vrf_interfaces_module.rst)|Manages VRF configuration on interfaces.
 [cisco.ios.ios_vxlan_vtep](https://github.com/ansible-collections/cisco.ios/blob/main/docs/cisco.ios.ios_vxlan_vtep_module.rst)|Resource module to configure VXLAN VTEP interface.
 
 <!--end collection content-->
@@ -142,10 +165,6 @@ Please read and familiarize yourself with this document.
 
 Release notes are available [here](https://github.com/ansible-collections/cisco.ios/blob/main/CHANGELOG.rst).
 
-## Roadmap
-
-<!-- Optional. Include the roadmap for this collection, and the proposed release/versioning strategy so users can anticipate the upgrade/update cycle. -->
-
 ## More information
 
 - [Ansible network resources](https://docs.ansible.com/ansible/latest/network/getting_started/network_resources.html)