oci/oracle: deprecation (#10652)

* oci/oracle: deprecation

* add changelog frag

* add doc frags to changelog frag

* Update changelogs/fragments/10652-oracle-deprecation.yml

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

---------

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

changelogs/fragments/10652-oracle-deprecation.yml

@@ -0,0 +1,4 @@
+deprecated_features:
+  - oci_utils module utils - utils is deprecated and will be removed in community.general 13.0.0 (https://github.com/ansible-collections/community.general/issues/10318, https://github.com/ansible-collections/community.general/pull/10652).
+  - oci_vcn - module is deprecated and will be removed in community.general 13.0.0 (https://github.com/ansible-collections/community.general/issues/10318, https://github.com/ansible-collections/community.general/pull/10652).
+  - oracle* doc fragments - fragments are deprecated and will be removed in community.general 13.0.0 (https://github.com/ansible-collections/community.general/issues/10318, https://github.com/ansible-collections/community.general/pull/10652).

meta/runtime.yml

@@ -477,6 +477,10 @@ plugin_routing:
       redirect: infoblox.nios_modules.nios_txt_record
     nios_zone:
       redirect: infoblox.nios_modules.nios_zone
+    oci_vcn:
+      deprecation:
+        removal_version: 13.0.0
+        warning_text: Use oracle.oci.oci_network_vcn instead.
     ome_device_info:
       redirect: dellemc.openmanage.ome_device_info
     one_image_facts:
@@ -1042,6 +1046,30 @@ plugin_routing:
       redirect: community.kubevirt.kubevirt_vm_options
     nios:
       redirect: infoblox.nios_modules.nios
+    oracle:
+      deprecation:
+        removal_version: 13.0.0
+        warning_text: Code is unmaintained here and official Oracle collection is available for a number of years.
+    oracle_creatable_resource:
+      deprecation:
+        removal_version: 13.0.0
+        warning_text: Code is unmaintained here and official Oracle collection is available for a number of years.
+    oracle_display_name_option:
+      deprecation:
+        removal_version: 13.0.0
+        warning_text: Code is unmaintained here and official Oracle collection is available for a number of years.
+    oracle_name_option:
+      deprecation:
+        removal_version: 13.0.0
+        warning_text: Code is unmaintained here and official Oracle collection is available for a number of years.
+    oracle_tags:
+      deprecation:
+        removal_version: 13.0.0
+        warning_text: Code is unmaintained here and official Oracle collection is available for a number of years.
+    oracle_wait_options:
+      deprecation:
+        removal_version: 13.0.0
+        warning_text: Code is unmaintained here and official Oracle collection is available for a number of years.
     postgresql:
       redirect: community.postgresql.postgresql
     proxmox:
@@ -1075,6 +1103,10 @@ plugin_routing:
       redirect: community.kubevirt.kubevirt
     net_tools.nios.api:
       redirect: infoblox.nios_modules.api
+    oci_utils:
+      deprecation:
+        removal_version: 13.0.0
+        warning_text: Code is unmaintained here and official Oracle collection is available for a number of years.
     postgresql:
       redirect: community.postgresql.postgresql
     proxmox:

plugins/doc_fragments/oracle.py

@@ -6,6 +6,12 @@
 from __future__ import (absolute_import, division, print_function)
 __metaclass__ = type
 
+#
+# DEPRECATED
+#
+# This fragment is deprecated and will be removed in community.general 13.0.0
+#
+
 
 class ModuleDocFragment(object):
     DOCUMENTATION = r"""

plugins/doc_fragments/oracle_creatable_resource.py

@@ -6,6 +6,12 @@
 from __future__ import (absolute_import, division, print_function)
 __metaclass__ = type
 
+#
+# DEPRECATED
+#
+# This fragment is deprecated and will be removed in community.general 13.0.0
+#
+
 
 class ModuleDocFragment(object):
     DOCUMENTATION = r"""

plugins/doc_fragments/oracle_display_name_option.py

@@ -6,6 +6,12 @@
 from __future__ import (absolute_import, division, print_function)
 __metaclass__ = type
 
+#
+# DEPRECATED
+#
+# This fragment is deprecated and will be removed in community.general 13.0.0
+#
+
 
 class ModuleDocFragment(object):
     DOCUMENTATION = r"""

plugins/doc_fragments/oracle_name_option.py

@@ -6,6 +6,12 @@
 from __future__ import (absolute_import, division, print_function)
 __metaclass__ = type
 
+#
+# DEPRECATED
+#
+# This fragment is deprecated and will be removed in community.general 13.0.0
+#
+
 
 class ModuleDocFragment(object):
     DOCUMENTATION = r"""

plugins/doc_fragments/oracle_tags.py

@@ -6,6 +6,12 @@
 from __future__ import (absolute_import, division, print_function)
 __metaclass__ = type
 
+#
+# DEPRECATED
+#
+# This fragment is deprecated and will be removed in community.general 13.0.0
+#
+
 
 class ModuleDocFragment(object):
     DOCUMENTATION = r"""

plugins/doc_fragments/oracle_wait_options.py

@@ -6,6 +6,12 @@
 from __future__ import (absolute_import, division, print_function)
 __metaclass__ = type
 
+#
+# DEPRECATED
+#
+# This fragment is deprecated and will be removed in community.general 13.0.0
+#
+
 
 class ModuleDocFragment(object):
     DOCUMENTATION = r"""

plugins/module_utils/oracle/oci_utils.py

@@ -6,6 +6,12 @@
 from __future__ import (absolute_import, division, print_function)
 __metaclass__ = type
 
+#
+# DEPRECATED
+#
+# This module utils is deprecated and will be removed in community.general 13.0.0
+#
+
 import logging
 import logging.config
 import os

plugins/modules/oci_vcn.py

@@ -11,6 +11,10 @@ __metaclass__ = type
 DOCUMENTATION = r"""
 module: oci_vcn
 short_description: Manage Virtual Cloud Networks(VCN) in OCI
+deprecated:
+  removed_in: 13.0.0
+  why: Superseded by official Oracle collection.
+  alternative: Use module C(oci_network_vcn) from the C(oracle.oci) collection.
 description:
   - This module allows the user to create, delete and update virtual cloud networks(VCNs) in OCI. The complete Oracle Cloud
     Infrastructure Ansible Modules can be downloaded from U(https://github.com/oracle/oci-ansible-modules/releases).