From 9e86d239d29c31940d195b8420348cc14c9b940c Mon Sep 17 00:00:00 2001 From: Alexei Znamensky <103110+russoz@users.noreply.github.com> Date: Sun, 24 Aug 2025 04:35:37 +1200 Subject: [PATCH] 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 --------- Co-authored-by: Felix Fontein --- .../fragments/10652-oracle-deprecation.yml | 4 +++ meta/runtime.yml | 32 +++++++++++++++++++ plugins/doc_fragments/oracle.py | 6 ++++ .../oracle_creatable_resource.py | 6 ++++ .../oracle_display_name_option.py | 6 ++++ plugins/doc_fragments/oracle_name_option.py | 6 ++++ plugins/doc_fragments/oracle_tags.py | 6 ++++ plugins/doc_fragments/oracle_wait_options.py | 6 ++++ plugins/module_utils/oracle/oci_utils.py | 6 ++++ plugins/modules/oci_vcn.py | 4 +++ 10 files changed, 82 insertions(+) create mode 100644 changelogs/fragments/10652-oracle-deprecation.yml diff --git a/changelogs/fragments/10652-oracle-deprecation.yml b/changelogs/fragments/10652-oracle-deprecation.yml new file mode 100644 index 0000000000..3842e994f8 --- /dev/null +++ b/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). diff --git a/meta/runtime.yml b/meta/runtime.yml index acb7397cae..e8ff28a3bc 100644 --- a/meta/runtime.yml +++ b/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: diff --git a/plugins/doc_fragments/oracle.py b/plugins/doc_fragments/oracle.py index 08b2948bf3..a35a2f0f2b 100644 --- a/plugins/doc_fragments/oracle.py +++ b/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""" diff --git a/plugins/doc_fragments/oracle_creatable_resource.py b/plugins/doc_fragments/oracle_creatable_resource.py index 5ccd6525c0..8507a1f45a 100644 --- a/plugins/doc_fragments/oracle_creatable_resource.py +++ b/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""" diff --git a/plugins/doc_fragments/oracle_display_name_option.py b/plugins/doc_fragments/oracle_display_name_option.py index ab219352e9..817cf93142 100644 --- a/plugins/doc_fragments/oracle_display_name_option.py +++ b/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""" diff --git a/plugins/doc_fragments/oracle_name_option.py b/plugins/doc_fragments/oracle_name_option.py index 5d5c97ef65..bdc6892681 100644 --- a/plugins/doc_fragments/oracle_name_option.py +++ b/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""" diff --git a/plugins/doc_fragments/oracle_tags.py b/plugins/doc_fragments/oracle_tags.py index 9cd35f9c7e..ba1c270803 100644 --- a/plugins/doc_fragments/oracle_tags.py +++ b/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""" diff --git a/plugins/doc_fragments/oracle_wait_options.py b/plugins/doc_fragments/oracle_wait_options.py index 90334711ee..667b1a952e 100644 --- a/plugins/doc_fragments/oracle_wait_options.py +++ b/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""" diff --git a/plugins/module_utils/oracle/oci_utils.py b/plugins/module_utils/oracle/oci_utils.py index 392692e7d5..442891018c 100644 --- a/plugins/module_utils/oracle/oci_utils.py +++ b/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 diff --git a/plugins/modules/oci_vcn.py b/plugins/modules/oci_vcn.py index 56a637ac2c..f5e6243a9a 100644 --- a/plugins/modules/oci_vcn.py +++ b/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).