~canonical-ci-engineering/charms/trusty/gunicorn/gunicorn-py3-support

« back to all changes in this revision

Viewing changes to README.rst

  • Committer: Mark Mims
  • Date: 2013-06-19 16:39:13 UTC
  • mfrom: (26.1.7 gunicorn)
  • Revision ID: mark.mims@canonical.com-20130619163913-o2ab5jd9hph6hd57
merging lp:~patrick-hetu/charms/precise/gunicorn/python-rewrite as per https://code.launchpad.net/~patrick-hetu/charms/precise/gunicorn/python-rewrite/+merge/167088

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Juju charm gunicorn
 
2
===================
 
3
 
 
4
:Author: Patrick Hetu <patrick@koumbit.org>
 
5
 
 
6
How to configure the charm
 
7
--------------------------
 
8
 
 
9
To deploy a charm with this subordinate it must minimaly:
 
10
 
 
11
  1. Provide the wsgi interface.
 
12
  2. Set the `working_dir` relation variable in the wsgi hook.
 
13
 
 
14
The configuration of Gunicorn will use the variable pass by
 
15
the relation hook first. If there are not define it will
 
16
fallback to the global configuration of the charm.
 
17
 
 
18
Example deployment
 
19
------------------
 
20
 
 
21
1. Deployment with python-moinmoin for example::
 
22
 
 
23
    juju bootstrap
 
24
    juju deploy --config mywiki_with_wsgi_settings.yaml python-moinmoin
 
25
    juju deploy gunicorn
 
26
    juju add-relation gunicorn python-moinmoin
 
27
    juju expose python-moinmoin
 
28
 
 
29
2. Accessing your new wiki should be ready at::
 
30
 
 
31
       http://<machine-addr>:8080/
 
32
 
 
33
   To find out the public address of gunicorn/python-moinmoin, look for it in
 
34
   the output of the `juju status` command.
 
35
   I recommend using a reverse proxy like Nginx in front of Gunicorn. 
 
36
 
 
37
Changelog
 
38
---------
 
39
3:
 
40
 
 
41
  Notable changes:
 
42
 
 
43
    * Rewrite the charm using python instead of BASH scripts
 
44
    * add listen_ip configuration variable
 
45
 
 
46
  Backwards incompatible changes:
 
47
    * Remove the Django mode since Gunicorn is not recommending it anymore.
 
48
    * Use Upstart to manage daemons
 
49
    * no start/stop hook anymore use related charms instead.
 
50
    * no configuration change directly on the charm anymore, use related charms instead.
 
51
    * no access logging by default
 
52
    * exposing a port must now be done in the linked charm instead of this one