Changes between Version 4 and Version 5 of TracDev/DevelopmentEnvironmentSetup

Timestamp:

Apr 26, 2008, 2:01:37 AM (16 years ago)

Author:

osimons

Comment:

Added development setup instructions for mod_wsgi with virtualenv.

TracDev/DevelopmentEnvironmentSetup

@@ -123 +123 @@
 PythonHandler myvirtualtrac
 }}}
+
+=== Alternative frontend: mod_wsgi ===
+
+Using Apache, mod_wsgi is a very good alternative to mod_python. Setting this up follows the same pattern, but for development escpecially there is one major advantage: It can quite easily be set up to auto-reload on code changes.
+
+'''Step 1:''' Update a default TracModWsgi setup to make a deamonised process, and as of mod_wsgi 2.0 (this setup depends on >= 2.0) there is built-in support for custom paths and similar. Example of a full `VirtualHost` configuration:
+
+{{{
+<VirtualHost *:80>
+    ServerName virtualtrac.local
+
+    # Update user and group to be whatever on your system is intended to run the deamon
+    # Update the paths to point to virtualenv site-packages (for trac+++) and bin (for script)
+    WSGIDaemonProcess tracdev user=www group=www threads=25 python-path=/path/to/my/virtualenv/lib/python2.4/site-packages:/path/to/my/virtualenv/bin
+
+    WSGIScriptAlias / /path/to/my/virtualenv/bin/tracdev.wsgi
+
+    <Location />
+      WSGIReloadMechanism Process
+      WSGIProcessGroup virtualtrac
+      WSGIApplicationGroup %{SERVER}
+      Order deny,allow
+      Allow from all
+    </Location>
+
+    # Authentication
+    <LocationMatch (/[^/.]+/login)>
+      # Note: Change settings with regards to auth method, paths and domain
+      AuthType Digest
+      AuthName "virtualtrac"
+      AuthDigestDomain /trac http://virtualtrac.local
+      AuthDigestProvider file
+      AuthUserFile /path/to/access.htdigest
+      Require valid-user
+    </LocationMatch>
+
+</VirtualHost>
+}}}
+
+'''Step 2:''' Go to http://code.google.com/p/modwsgi/wiki/ReloadingSourceCode and save the long Python script that follows the text 'Example code for such an automatic restart mechanism...'. Save it as `/path/to/my/virtualenv/bin/monitor.py` 
+
+'''Step 3:''' A basic WSGI frontend script
+
+{{{
+#!python
+
+import sys
+sys.stdout = sys.stderr
+
+import os
+os.environ['TRAC_ENV_DIR'] = "/path/to/trac/project"
+# or, alternatively for multiple projects
+#os.environ['TRAC_ENV_PARENT_DIR'] = "/parent/path/to/many/projects"
+os.environ['PYTHON_EGG_CACHE'] = '/path/to/a/temp/to/cache/eggs'
+
+import trac.web.main
+
+import monitor
+monitor.start(interval=1.0)
+# Additionally monitor easy-install.pth to restart whenever installs are done
+monitor.track('/path/to/my/virtualenv/lib/python2.4/site-packages/easy-install.pth')
+
+application = trac.web.main.dispatch_request
+}}}