[PR #10026/63cb8f0a backport][stable-10] deprecation: stackpath_compute (#10037)

deprecation: stackpath_compute (#10026)

* deprecation: stackpath_compute

* add changelog frag

* restore test file

(cherry picked from commit 63cb8f0ace)

Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>

changelogs/fragments/10026-stackpath-compute-deprecation.yml

@@ -0,0 +1,2 @@
+deprecated_features:
+  - stackpath_compute inventory plugin - plugin is deprecated and will be removed in community.general 11.0.0 (https://github.com/ansible-collections/community.general/pull/10026).

meta/runtime.yml

@@ -964,6 +964,10 @@ plugin_routing:
       redirect: community.docker.docker_swarm
     kubevirt:
       redirect: community.kubevirt.kubevirt
+    stackpath_compute:
+      deprecation:
+        removal_version: 11.0.0
+        warning_text: The company and the service were sunset in June 2024.
   filter:
     path_join:
       # The ansible.builtin.path_join filter has been added in ansible-base 2.10.

plugins/inventory/stackpath_compute.py

@@ -6,12 +6,16 @@
 
 from __future__ import annotations
 
-DOCUMENTATION = '''
+DOCUMENTATION = r"""
 name: stackpath_compute
 short_description: StackPath Edge Computing inventory source
 version_added: 1.2.0
 author:
   - UNKNOWN (@shayrybak)
+deprecated:
+  removed_in: 11.0.0
+  why: Stackpath (the company) ceased its operations in June 2024. The API URL this plugin relies on is not found in DNS.
+  alternative: There is none.
 extends_documentation_fragment:
   - inventory_cache
   - constructed
@@ -27,14 +31,12 @@ DOCUMENTATION = '''
     choices: ['community.general.stackpath_compute']
   client_id:
     description:
-                - An OAuth client ID generated from the API Management section of the StackPath customer portal
+      - An OAuth client ID generated from the API Management section of the StackPath customer portal U(https://control.stackpath.net/api-management).
-                  U(https://control.stackpath.net/api-management).
     required: true
     type: str
   client_secret:
     description:
-                - An OAuth client secret generated from the API Management section of the StackPath customer portal
+      - An OAuth client secret generated from the API Management section of the StackPath customer portal U(https://control.stackpath.net/api-management).
-                  U(https://control.stackpath.net/api-management).
     required: true
     type: str
   stack_slugs:
@@ -47,11 +49,9 @@ DOCUMENTATION = '''
       - Whether or not to use internal IP addresses, If false, uses external IP addresses, internal otherwise.
       - If an instance doesn't have an external IP it will not be returned when this option is set to false.
     type: bool
-'''
+"""
 
-EXAMPLES = '''
+EXAMPLES = r"""
-# Example using credentials to fetch all workload instances in a stack.
----
 plugin: community.general.stackpath_compute
 client_id: my_client_id
 client_secret: my_client_secret
@@ -59,7 +59,7 @@ stack_slugs:
   - my_first_stack_slug
   - my_other_stack_slug
 use_internal_ip: false
-'''
+"""
 
 import traceback
 import json