Opened 7 years ago

Last modified 10 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 Aymeric Augustin, 7 years ago

Triage Stage: UnreviewedAccepted

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.

comment:2 by Tim Graham, 7 years ago

Summary: Update mod_wsgi deployment documentationDocument 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 Aymeric Augustin, 7 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 Vincent Lefoulon, 7 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 Tim Graham, 7 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 David Smith, 3 years ago

Easy pickings: set

comment:8 by Kshitij Raghav, 3 years ago

Owner: changed from nobody to Kshitij Raghav
Status: newassigned

Successfully Modified the documentation and added a pull request( waiting to be merged )

comment:9 by Tim Graham, 3 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.

PR

comment:10 by Jacob Walls, 3 years ago

Patch needs improvement: set

comment:11 by za, 2 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 Egor R, 2 years ago

Cc: Egor R added

comment:13 by Mariusz Felisiak, 2 years ago

Easy pickings: unset
Patch needs improvement: set

comment:14 by Mariusz Felisiak, 10 months ago

Owner: Kshitij Raghav removed
Status: assignednew
Note: See TracTickets for help on using tickets.
Back to Top