Opened 8 years ago
Last modified 18 months ago
#27925 new Cleanup/optimization
Document how to deploy using pip installed mod_wsgi
Reported by: | Vincent Lefoulon | Owned by: | |
---|---|---|---|
Component: | Documentation | Version: | 1.10 |
Severity: | Normal | Keywords: | mod_wsgi, apache |
Cc: | Egor R | Triage Stage: | Accepted |
Has patch: | yes | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | yes |
Easy pickings: | no | UI/UX: | no |
Description
Hi!
The current documentation page about mod_wsgi (https://docs.djangoproject.com/en/1.10/howto/deployment/wsgi/modwsgi/) explains how to set it up manually. Personnally, I never managed to deploy that way. Instead, I use the Python module (https://github.com/GrahamDumpleton/mod_wsgi#installation-into-python), with which I have no problems.
Moreover, using the Python module seems to be recommended: "The second and newest way of installing mod_wsgi is to install it as a Python package into your Python installation using the Python pip install command."
Maybe we could update the documentation.
Thanks.
PS: that's my first ticket, I hope I am doing it the right way.
Change History (13)
comment:1 by , 8 years ago
Triage Stage: | Unreviewed → Accepted |
---|
comment:2 by , 8 years ago
Summary: | Update mod_wsgi deployment documentation → Document how to deploy using pip installed mod_wsgi |
---|
I'm not sure how much information we need to duplicate in Django's docs, linking to Using mod_wsgi-express with Django might be enough?
comment:3 by , 8 years ago
I think our documentation should contain a minimal working example corresponding to what we consider the best practice for a trivial site and point to mod_wsgi's documentation for anything else. There's a good chance our example will match mod_wsgi's 101 for running Django.
comment:4 by , 8 years ago
Maybe the documentation could also mention the Docker image, really useful for trying and deploy: https://hub.docker.com/r/grahamdumpleton/mod-wsgi-docker/
comment:5 by , 8 years ago
I agree with Aymeric about including a minimal working example, however, I think pointing to third-party resources like the Docker image is outside the scope of our documentation -- maybe it's appropriate for mod_wsgi's docs though.
comment:7 by , 4 years ago
Easy pickings: | set |
---|
comment:8 by , 4 years ago
Owner: | changed from | to
---|---|
Status: | new → assigned |
Successfully Modified the documentation and added a pull request( waiting to be merged )
comment:9 by , 4 years ago
Has patch: | set |
---|
Kshitij, for future reference, you should link to your PR and check "Has patch" on this ticket so the patch appears in the review queue. I will do that now.
comment:10 by , 3 years ago
Patch needs improvement: | set |
---|
comment:11 by , 3 years ago
Patch needs improvement: | unset |
---|
Hi Kshitij, I've wrapped the lines into 79 chars here: https://github.com/django/django/pull/14939
comment:12 by , 3 years ago
Cc: | added |
---|
comment:13 by , 3 years ago
Easy pickings: | unset |
---|---|
Patch needs improvement: | set |
comment:14 by , 18 months ago
Owner: | removed |
---|---|
Status: | assigned → new |
Indeed,
pip install mod_wsgi
(a recent addition) is significantly easier than previous solutions. It also works fine with pyenv (e.g. if you want to run a not-too-old Python on Debian stable). Let's do this.