ansible-test - Deprecate the foreman test plugin (#79821)

changelogs/fragments/ansible-test-foreman.yml

@@ -0,0 +1,3 @@
+deprecated_features:
+  - ansible-test - The ``foreman`` test plugin is now deprecated.
+                   It will be removed in a future release.

test/lib/ansible_test/_internal/commands/integration/cloud/foreman.py

@@ -12,6 +12,10 @@ from ....containers import (
     run_support_container,
 )
 
+from ....util import (
+    display,
+)
+
 from . import (
     CloudEnvironment,
     CloudEnvironmentConfig,
@@ -50,6 +54,8 @@ class ForemanProvider(CloudProvider):
         """Setup cloud resource before delegation and reg cleanup callback."""
         super().setup()
 
+        display.warning('The foreman test plugin is deprecated and will be removed in a future version of ansible-test.')
+
         if self._use_static_config():
             self._setup_static()
         else: