From 065ce3a134e99963595110cabbbbfdc7a4b60fd2 Mon Sep 17 00:00:00 2001
From: Alexei Znamensky <103110+russoz@users.noreply.github.com>
Date: Thu, 13 Jul 2023 22:50:43 +1200
Subject: [PATCH] stackdriver: deprecate module (#6887)

* stackdriver: deprecate module

* add changelog frag

* Update changelogs/fragments/6887-deprecate-stackdrive.yml

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

* fix removal version

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
---
 changelogs/fragments/6887-deprecate-stackdrive.yml | 2 ++
 meta/runtime.yml                                   | 6 ++++++
 plugins/modules/stackdriver.py                     | 5 +++++
 3 files changed, 13 insertions(+)
 create mode 100644 changelogs/fragments/6887-deprecate-stackdrive.yml

diff --git a/changelogs/fragments/6887-deprecate-stackdrive.yml b/changelogs/fragments/6887-deprecate-stackdrive.yml
new file mode 100644
index 0000000000..f480f70861
--- /dev/null
+++ b/changelogs/fragments/6887-deprecate-stackdrive.yml
@@ -0,0 +1,2 @@
+deprecated_features:
+  - stackdriver - module relies entirely on no longer existent API endpoints, and it will be removed in community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6887).
diff --git a/meta/runtime.yml b/meta/runtime.yml
index 5399956788..8131b1c10e 100644
--- a/meta/runtime.yml
+++ b/meta/runtime.yml
@@ -150,6 +150,12 @@ plugin_routing:
         warning_text: You are using an internal name to access the community.general.airbrake_deployment
           modules. This has never been supported or documented, and will stop working
           in community.general 9.0.0.
+    stackdriver:
+      deprecation:
+        removal_version: 9.0.0
+        warning_text: >
+          This module relies on HTTPS APIs that do not exist anymore, and any new development in the
+          direction of providing an alternative should happen in the context of the google.cloud collection.
     system.aix_devices:
       redirect: community.general.aix_devices
       deprecation:
diff --git a/plugins/modules/stackdriver.py b/plugins/modules/stackdriver.py
index cf7cb2f475..35b2b0dc16 100644
--- a/plugins/modules/stackdriver.py
+++ b/plugins/modules/stackdriver.py
@@ -10,6 +10,11 @@ __metaclass__ = type
 
 DOCUMENTATION = '''
 
+deprecated:
+  removed_in: 9.0.0
+  why: the endpoints this module relies on do not exist any more and do not resolve to IPs in DNS.
+  alternative: no known alternative at this point
+
 module: stackdriver
 short_description: Send code deploy and annotation events to stackdriver
 description: