enable trove-api behind mod-wsgi

This change enables behind mod-wsgi as part of the community pike goal
goal-deploy-api-in-wsgi.

The change includes:

    - the wsgi script files to run trove api under apache
    - updates to the devstack plugin
    - a basic deploy doc which explains this change

Change-Id: Icdd39b47a1be426e87a5d09f9e9d567af1974a9c
Depends-On: I3d6f6649430ee40879de15fee0b215dc32e8b666
Closes-Bug: #1681478

1 files changed, 36 insertions, 0 deletions

diff --git a/etc/apache2/trove b/etc/apache2/trove
new file mode 100644
index 00000000..b6341f95
--- /dev/null
+++ b/etc/apache2/trove
@@ -0,0 +1,36 @@
+# Copyright 2017 Amrith Kumar.
+# All Rights Reserved.
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+# This is an example Apache2 configuration file for using Trove API
+through mod_wsgi
+
+Listen 8779
+
+<VirtualHost *:8779>
+    WSGIDaemonProcess trove-api user=stack group=stack processes=2 threads=2 display-name=%{GROUP}
+    WSGIScriptAlias / /opt/stack/trove/trove/cmd/app.wsgi
+    WSGIProcessGroup trove-api
+
+    ErrorLog /var/log/httpd/trove_error.log
+    LogLevel info
+    CustomLog /var/log/httpd/trove_access.log combined
+
+    <Directory /opt/stack/trove/trove/cmd>
+        WSGIProcessGroup trove-api
+        WSGIApplicationGroup %{GLOBAL}
+        AllowOverride All
+        Require all granted
+    </Directory>
+</VirtualHost>
+