Deprecate console scripts for api services

Current standalone api services heavily depend on WSGI server
implementation of eventlet and we aim to completely get rid of it as
part of the effort to get rid of eventlet.

It is now officially recommended to use the wsgi scripts or
applications and run these by a 3rd party mechanism such as uwsgi or
httpd + mod_wsgi.

Change-Id: I91457df91bb2e6f6710af6f4fc19b11527d8e4c3

heat/cmd/api.py

@@ -22,6 +22,7 @@ import eventlet
 eventlet.monkey_patch(os=False)
 
 import sys
+import warnings
 
 from oslo_config import cfg
 import oslo_i18n as i18n
@@ -68,6 +69,9 @@ def launch_api(setup_logging=True):
 
 
 def main():
+    warnings.warn("The heat-api script has been deprecated and will be "
+                  "removed in the future.",
+                  DeprecationWarning)
     try:
         server = launch_api()
         systemd.notify_once()

heat/cmd/api_cfn.py

@@ -24,6 +24,7 @@ import eventlet
 eventlet.monkey_patch(os=False)
 
 import sys
+import warnings
 
 from oslo_config import cfg
 import oslo_i18n as i18n
@@ -72,6 +73,9 @@ def launch_cfn_api(setup_logging=True):
 
 
 def main():
+    warnings.warn("The heat-api script has been deprecated and will be "
+                  "removed in the future.",
+                  DeprecationWarning)
     try:
         server = launch_cfn_api()
         systemd.notify_once()

releasenotes/notes/deprecate-api-console-scripts-b5c0b734fccd82bd.yaml

@@ -0,0 +1,7 @@
+---
+deprecations:
+  - |
+    The ``heat-api`` console script and the ``heat-api-cfn`` console script,
+    which are used to launch standalone api services, have been deprecated and
+    will be removed in a future release. It is now highly recommended to Use
+    the wsgi scripts (or wsgi applications directly) instead.