[Django] #27925: Update mod_wsgi deployment documentation
Django
-------------------------------------+-------------------------------------
Reporter: Vincent | Owner: nobody
Lefoulon |
Type: | Status: new
Cleanup/optimization |
Component: | Version: 1.10
Documentation |
Severity: Normal | Keywords: mod_wsgi, apache
Triage Stage: | Has patch: 0
Unreviewed |
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-------------------------------------+-------------------------------------
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.
--
Ticket URL: <https://code.djangoproject.com/ticket/27925>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
Django
Reporter: Vincent Lefoulon | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Keywords: mod_wsgi, apache | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Changes (by Aymeric Augustin):
* stage: Unreviewed => Accepted
Comment:
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.
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:1>
Django
--------------------------------------+------------------------------------
Reporter: Vincent Lefoulon | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Tim Graham):
I'm not sure how much information we need to duplicate in Django's docs,
linking to [https://github.com/GrahamDumpleton/mod_wsgi#using-mod_wsgi-
express-with-django Using mod_wsgi-express with Django] might be enough?
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:2>
Django
--------------------------------------+------------------------------------
Reporter: Vincent Lefoulon | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Aymeric Augustin):
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.
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:3>
Django
--------------------------------------+------------------------------------
Reporter: Vincent Lefoulon | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Vincent Lefoulon):
Maybe the documentation could also mention the Docker image, really useful
for trying and deploy: https://hub.docker.com/r/grahamdumpleton/mod-wsgi-
docker/
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:4>
Django
--------------------------------------+------------------------------------
Reporter: Vincent Lefoulon | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Comment (by Tim Graham):
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.
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:5>
Django
Reporter: Vincent Lefoulon | Owner:
Type: | cleopatra27
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
* owner: nobody => cleopatra27
* status: new => assigned
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:6>
Django
-------------------------------------+-------------------------------------
Type: | douglas
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
-------------------------------------+-------------------------------------
Changes (by David Smith):
* easy: 0 => 1
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:7>
Django
Reporter: Vincent Lefoulon | Owner: (none)
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
--------------------------------------+------------------------------------
Changes (by David Smith):
* owner: cleopatra douglas => (none)
* status: assigned => new
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:8>
Django
Reporter: Vincent Lefoulon | Owner: Kshitij
Type: | Raghav
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
-------------------------------------+-------------------------------------
* owner: nobody => Kshitij Raghav
* status: new => assigned
Comment:
Successfully Modified the documentation and added a pull request( waiting
to be merged )
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:8>
Django
-------------------------------------+-------------------------------------
Reporter: Vincent Lefoulon | Owner: Kshitij
Type: | Raghav
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
-------------------------------------+-------------------------------------
* has_patch: 0 => 1
Comment:
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.
[https://github.com/django/django/pull/14200 PR]
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:9>
Django
-------------------------------------+-------------------------------------
Reporter: Vincent Lefoulon | Owner: Kshitij
Type: | Raghav
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
* needs_better_patch: 0 => 1
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:10>
Django
-------------------------------------+-------------------------------------
Reporter: Vincent Lefoulon | Owner: Kshitij
Type: | Raghav
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
-------------------------------------+-------------------------------------
* needs_better_patch: 1 => 0
Comment:
Hi Kshitij, I've wrapped the lines into 79 chars here:
https://github.com/django/django/pull/14939
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:11>
Django
-------------------------------------+-------------------------------------
Reporter: Vincent Lefoulon | Owner: Kshitij
Type: | Raghav
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
-------------------------------------+-------------------------------------
* cc: Egor R (added)
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:12>
Django
-------------------------------------+-------------------------------------
Reporter: Vincent Lefoulon | Owner: Kshitij
Type: | Raghav
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
* needs_better_patch: 0 => 1
* easy: 1 => 0
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:13>
Django
Reporter: Vincent Lefoulon | Owner: (none)
Type: Cleanup/optimization | Status: new
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 0 | UI/UX: 0
Changes (by Mariusz Felisiak):
* owner: Kshitij Raghav => (none)
* status: assigned => new
--
Ticket URL: <https://code.djangoproject.com/ticket/27925#comment:14>