docs/source/deploying.rst

   1 .. _deploying:
   2
   3 Deployment
   4 ==========
   5
   6 If you haven't already :ref:`configured <configuring>` |gwm|, now would
   7 be a good time to do so.
   8
   9 Now that you have a |gwm| instance setup and configured, you will want
  10 to deploy it to somewhere that can be accessed by a web browser.
  11
  12
  13 .. _test-server:
  14
  15 Testing
  16 -------
  17 If you are just testing |gwm| out, run::
  18
  19     $ python manage.py runserver
  20
  21 Then open a web browser, and navigate to
  22 `http://localhost:8000`.
  23
  24 ::
  25
  26    firefox http://localhost:8000
  27
  28
  29 Apache + mod_wsgi
  30 -----------------
  31
  32 Follow the django guide to `deploy with
  33 apache. <https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/modwsgi/>`_
  34 Here is an example mod\_wsgi file:
  35
  36 ::
  37
  38     import os
  39     import sys
  40
  41     path = '/var/lib/django/ganeti_webmgr'
  42
  43     # activate virtualenv
  44     activate_this = '%s/venv/bin/activate_this.py' % path
  45     execfile(activate_this, dict(__file__=activate_this))
  46
  47     # add project to path
  48     if path not in sys.path:
  49         sys.path.append(path)
  50
  51     # configure django environment
  52     os.environ['DJANGO_SETTINGS_MODULE'] = 'settings'
  53
  54     import django.core.handlers.wsgi
  55     application = django.core.handlers.wsgi.WSGIHandler()
  56
  57 Virtualenv
  58 ~~~~~~~~~~
  59
  60 The virtual environment must be activated for use with mod\_wsgi. This
  61 is done by executing the **activate\_this** script generated when a
  62 virtualenv is created. The following code should be in the
  63 **django.wsgi** file apache is configured to use.
  64
  65 ::
  66
  67     # activate virtual environment
  68     activate_this = '%s/venv/bin/activate_this.py' % PATH_TO_GANETI_WEBMGR
  69     execfile(activate_this, dict(__file__=activate_this))
  70
  71 Nginx
  72 -----
  73
  74
  75 Gunicorn
  76 --------
  77
  78
  79 uWSGI
  80 -----