Deprecate nios content (#2458) (#2504)

* Deprecate nios content.

* Make 2.9's ansible-test happy.

* Add module_utils deprecation.

(cherry picked from commit ee9770cff7)

Co-authored-by: Felix Fontein <felix@fontein.de>

changelogs/fragments/nios-deprecation.yml

@@ -0,0 +1,2 @@
+deprecated_features:
+- "The nios, nios_next_ip, nios_next_network lookup plugins, the nios documentation fragment, and the nios_host_record, nios_ptr_record, nios_mx_record, nios_fixed_address, nios_zone, nios_member, nios_a_record, nios_aaaa_record, nios_network, nios_dns_view, nios_txt_record, nios_naptr_record, nios_srv_record, nios_cname_record, nios_nsgroup, and nios_network_view module have been deprecated and will be removed from community.general 5.0.0. Please install the `infoblox.nios_modules <https://galaxy.ansible.com/infoblox/nios_modules>`_ collection instead and use its plugins and modules (https://github.com/ansible-collections/community.general/pull/2458)."

meta/runtime.yml

@@ -37,6 +37,18 @@ plugin_routing:
       redirect: community.google.gcp_storage_file
     hashi_vault:
       redirect: community.hashi_vault.hashi_vault
+    nios:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios lookup plugin has been deprecated. Please use infoblox.nios_modules.nios_lookup instead.
+    nios_next_ip:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_next_ip lookup plugin has been deprecated. Please use infoblox.nios_modules.nios_next_ip instead.
+    nios_next_network:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_next_network lookup plugin has been deprecated. Please use infoblox.nios_modules.nios_next_network instead.
   modules:
     ali_instance_facts:
       tombstone:
@@ -283,6 +295,70 @@ plugin_routing:
       tombstone:
         removal_version: 3.0.0
         warning_text: Use netapp.ontap.na_ontap_info instead.
+    nios_a_record:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_a_record module has been deprecated. Please use infoblox.nios_modules.nios_a_record instead.
+    nios_aaaa_record:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_aaaa_record module has been deprecated. Please use infoblox.nios_modules.nios_aaaa_record instead.
+    nios_cname_record:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_cname_record module has been deprecated. Please use infoblox.nios_modules.nios_cname_record instead.
+    nios_dns_view:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_dns_view module has been deprecated. Please use infoblox.nios_modules.nios_dns_view instead.
+    nios_fixed_address:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_fixed_address module has been deprecated. Please use infoblox.nios_modules.nios_fixed_address instead.
+    nios_host_record:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_host_record module has been deprecated. Please use infoblox.nios_modules.nios_host_record instead.
+    nios_member:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_member module has been deprecated. Please use infoblox.nios_modules.nios_member instead.
+    nios_mx_record:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_mx_record module has been deprecated. Please use infoblox.nios_modules.nios_mx_record instead.
+    nios_naptr_record:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_naptr_record module has been deprecated. Please use infoblox.nios_modules.nios_naptr_record instead.
+    nios_network:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_network module has been deprecated. Please use infoblox.nios_modules.nios_network instead.
+    nios_network_view:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_network_view module has been deprecated. Please use infoblox.nios_modules.nios_network_view instead.
+    nios_nsgroup:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_nsgroup module has been deprecated. Please use infoblox.nios_modules.nios_nsgroup instead.
+    nios_ptr_record:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_ptr_record module has been deprecated. Please use infoblox.nios_modules.nios_ptr_record instead.
+    nios_srv_record:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_srv_record module has been deprecated. Please use infoblox.nios_modules.nios_srv_record instead.
+    nios_txt_record:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_txt_record module has been deprecated. Please use infoblox.nios_modules.nios_txt_record instead.
+    nios_zone:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios_zone module has been deprecated. Please use infoblox.nios_modules.nios_zone instead.
     nginx_status_facts:
       tombstone:
         removal_version: 3.0.0
@@ -568,11 +644,13 @@ plugin_routing:
       redirect: community.kubevirt.kubevirt_common_options
     kubevirt_vm_options:
       redirect: community.kubevirt.kubevirt_vm_options
+    nios:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.nios document fragment has been deprecated. Please use infoblox.nios_modules.nios instead.
     postgresql:
       redirect: community.postgresql.postgresql
   module_utils:
-    remote_management.dellemc.dellemc_idrac:
-      redirect: dellemc.openmanage.dellemc_idrac
     docker.common:
       redirect: community.docker.common
     docker.swarm:
@@ -587,6 +665,12 @@ plugin_routing:
       redirect: community.hrobot.robot
     kubevirt:
       redirect: community.kubevirt.kubevirt
+    net_tools.nios.api:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: The community.general.net_tools.nios.api module_utils has been deprecated. Please use infoblox.nios_modules.api instead.
+    remote_management.dellemc.dellemc_idrac:
+      redirect: dellemc.openmanage.dellemc_idrac
     remote_management.dellemc.ome:
       redirect: dellemc.openmanage.ome
     postgresql:

plugins/lookup/nios.py

@@ -25,6 +25,10 @@ DOCUMENTATION = '''
 author: Unknown (!UNKNOWN)
 name: nios
 short_description: Query Infoblox NIOS objects
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding lookup from it.
+    alternative: infoblox.nios_modules.nios_lookup
+    removed_in: 5.0.0
 description:
   - Uses the Infoblox WAPI API to fetch NIOS specified objects.  This lookup
     supports adding additional keywords to filter the return data and specify

plugins/lookup/nios_next_ip.py

@@ -25,6 +25,10 @@ DOCUMENTATION = '''
 author: Unknown (!UNKNOWN)
 name: nios_next_ip
 short_description: Return the next available IP address for a network
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding lookup from it.
+    alternative: infoblox.nios_modules.nios_next_ip
+    removed_in: 5.0.0
 description:
   - Uses the Infoblox WAPI API to return the next available IP addresses
     for a given network CIDR

plugins/lookup/nios_next_network.py

@@ -25,6 +25,10 @@ DOCUMENTATION = '''
 author: Unknown (!UNKNOWN)
 name: nios_next_network
 short_description: Return the next available network range for a network-container
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding lookup from it.
+    alternative: infoblox.nios_modules.nios_next_network
+    removed_in: 5.0.0
 description:
   - Uses the Infoblox WAPI API to return the next available network addresses for
     a given network CIDR

plugins/modules/net_tools/nios/nios_a_record.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_a_record
 author: "Blair Rampling (@brampling)"
 short_description: Configure Infoblox NIOS A records
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_a_record
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of A record objects from
     Infoblox NIOS servers.  This module manages NIOS C(record:a) objects

plugins/modules/net_tools/nios/nios_aaaa_record.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_aaaa_record
 author: "Blair Rampling (@brampling)"
 short_description: Configure Infoblox NIOS AAAA records
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_aaaa_record
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of AAAA record objects from
     Infoblox NIOS servers.  This module manages NIOS C(record:aaaa) objects

plugins/modules/net_tools/nios/nios_cname_record.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_cname_record
 author: "Blair Rampling (@brampling)"
 short_description: Configure Infoblox NIOS CNAME records
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_cname_record
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of CNAME record objects from
     Infoblox NIOS servers.  This module manages NIOS C(record:cname) objects

plugins/modules/net_tools/nios/nios_dns_view.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_dns_view
 author: "Peter Sprygada (@privateip)"
 short_description: Configure Infoblox NIOS DNS views
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_dns_view
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of DNS view objects from
     Infoblox NIOS servers.  This module manages NIOS C(view) objects

plugins/modules/net_tools/nios/nios_fixed_address.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_fixed_address
 author: "Sumit Jaiswal (@sjaiswal)"
 short_description: Configure Infoblox NIOS DHCP Fixed Address
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_fixed_address
+    removed_in: 5.0.0
 description:
   - A fixed address is a specific IP address that a DHCP server
     always assigns when a lease request comes from a particular

plugins/modules/net_tools/nios/nios_host_record.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_host_record
 author: "Peter Sprygada (@privateip)"
 short_description: Configure Infoblox NIOS host records
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_host_record
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of host record objects from
     Infoblox NIOS servers.  This module manages NIOS C(record:host) objects

plugins/modules/net_tools/nios/nios_member.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_member
 author: "Krishna Vasudevan (@krisvasudevan)"
 short_description: Configure Infoblox NIOS members
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_member
+    removed_in: 5.0.0
 description:
   - Adds and/or removes Infoblox NIOS servers.  This module manages NIOS C(member) objects using the Infoblox WAPI interface over REST.
 requirements:

plugins/modules/net_tools/nios/nios_mx_record.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_mx_record
 author: "Blair Rampling (@brampling)"
 short_description: Configure Infoblox NIOS MX records
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_mx_record
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of MX record objects from
     Infoblox NIOS servers.  This module manages NIOS C(record:mx) objects

plugins/modules/net_tools/nios/nios_naptr_record.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_naptr_record
 author: "Blair Rampling (@brampling)"
 short_description: Configure Infoblox NIOS NAPTR records
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_naptr_record
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of NAPTR record objects from
     Infoblox NIOS servers.  This module manages NIOS C(record:naptr) objects

plugins/modules/net_tools/nios/nios_network.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_network
 author: "Peter Sprygada (@privateip)"
 short_description: Configure Infoblox NIOS network object
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_network
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of network objects from
     Infoblox NIOS servers.  This module manages NIOS C(network) objects

plugins/modules/net_tools/nios/nios_network_view.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_network_view
 author: "Peter Sprygada (@privateip)"
 short_description: Configure Infoblox NIOS network views
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_network_view
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of network view objects from
     Infoblox NIOS servers.  This module manages NIOS C(networkview) objects

plugins/modules/net_tools/nios/nios_nsgroup.py

@@ -11,6 +11,10 @@ DOCUMENTATION = '''
 ---
 module: nios_nsgroup
 short_description: Configure InfoBlox DNS Nameserver Groups
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_nsgroup
+    removed_in: 5.0.0
 extends_documentation_fragment:
 - community.general.nios
 

plugins/modules/net_tools/nios/nios_ptr_record.py

@@ -11,6 +11,10 @@ DOCUMENTATION = '''
 module: nios_ptr_record
 author: "Trebuchet Clement (@clementtrebuchet)"
 short_description: Configure Infoblox NIOS PTR records
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_ptr_record
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of PTR record objects from
     Infoblox NIOS servers.  This module manages NIOS C(record:ptr) objects

plugins/modules/net_tools/nios/nios_srv_record.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_srv_record
 author: "Blair Rampling (@brampling)"
 short_description: Configure Infoblox NIOS SRV records
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_srv_record
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of SRV record objects from
     Infoblox NIOS servers.  This module manages NIOS C(record:srv) objects

plugins/modules/net_tools/nios/nios_txt_record.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_txt_record
 author: "Corey Wanless (@coreywan)"
 short_description: Configure Infoblox NIOS txt records
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_txt_record
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of txt record objects from
     Infoblox NIOS servers.  This module manages NIOS C(record:txt) objects

plugins/modules/net_tools/nios/nios_zone.py

@@ -10,6 +10,10 @@ DOCUMENTATION = '''
 module: nios_zone
 author: "Peter Sprygada (@privateip)"
 short_description: Configure Infoblox NIOS DNS zones
+deprecated:
+    why: Please install the infoblox.nios_modules collection and use the corresponding module from it.
+    alternative: infoblox.nios_modules.nios_zone
+    removed_in: 5.0.0
 description:
   - Adds and/or removes instances of DNS zone objects from
     Infoblox NIOS servers.  This module manages NIOS C(zone_auth) objects

tests/sanity/ignore-2.9.txt

@@ -43,6 +43,38 @@ plugins/modules/remote_management/manageiq/manageiq_provider.py validate-modules
 plugins/modules/remote_management/stacki/stacki_host.py validate-modules:doc-default-does-not-match-spec
 plugins/modules/remote_management/stacki/stacki_host.py validate-modules:parameter-type-not-in-doc
 plugins/modules/remote_management/stacki/stacki_host.py validate-modules:undocumented-parameter
+plugins/modules/net_tools/nios/nios_a_record.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_a_record.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_aaaa_record.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_aaaa_record.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_cname_record.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_cname_record.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_dns_view.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_dns_view.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_fixed_address.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_fixed_address.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_host_record.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_host_record.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_member.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_member.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_mx_record.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_mx_record.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_naptr_record.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_naptr_record.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_network.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_network.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_network_view.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_network_view.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_nsgroup.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_nsgroup.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_ptr_record.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_ptr_record.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_srv_record.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_srv_record.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_txt_record.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_txt_record.py validate-modules:invalid-documentation
+plugins/modules/net_tools/nios/nios_zone.py validate-modules:deprecation-mismatch
+plugins/modules/net_tools/nios/nios_zone.py validate-modules:invalid-documentation
 plugins/modules/source_control/github/github_deploy_key.py validate-modules:parameter-invalid
 plugins/modules/system/iptables_state.py validate-modules:undocumented-parameter
 plugins/modules/system/launchd.py use-argspec-type-path  # False positive