Task #3132
closed
Document how to deploy Pulp
Status:
CLOSED - CURRENTRELEASE
Description
Users should have docs on how they can configure the webserver to serve Pulp. This should be a "Webserver" section on a new page to be created in the docs called "Deploying".
These docs should explain to the user the top level url(s) hat need to be matched for the "content" part of Pulp and the "REST API". Specifically the "content" part needs to match on /content/
and route that to the Pulp WSGI app. For the REST API part it needs to match on both /api/v3/
.
This documentation should not give examples for specific webservers. It should generally fulfill the following requirements:
As a deployer of Pulp, I understand the urls Pulp needs to serve the "Content" part of Pulp and that I need to route them to the Pulp WSGI app
As a deployer of Pulp, I understand the urls Pulp needs to serve the REST API and that I need to route them to the Pulp WSGI app
- Tracker changed from Issue to Task
- % Done set to 0
- Description updated (diff)
A question came up asking if this was making two new django apps. I had not planned on splitting the Django apps because practically speaking it would be hard to do so. Without actually making the content app a separate Django app, we aren't creating any value by having the same Django app served in another WSGI file with a different name.
Practically speaking, we don't need to ship multiple Django apps for the Pulp3 MVP, so I recommend this be closed as NOTABUG.
- Subject changed from Create and document WSGI applications to Document how to deploy Pulp
- Description updated (diff)
- Tags Documentation added
Rewriting after IRC convo where the goal became to convert this to a docs story and document the Pulp requirements.
- Groomed changed from No to Yes
- Sprint/Milestone set to 48
- Has duplicate Task #3114: Document the webserver requirements added
- Related to Task #2922: Create and publish an ansible role to install and configure nginx for pulp added
- Related to Task #2921: Create and publish an ansible role to install apache and configure it for pulp added
- Sprint/Milestone changed from 48 to 52
- Sprint/Milestone changed from 52 to 53
- Sprint/Milestone changed from 53 to 54
- Sprint/Milestone changed from 54 to 56
- Sprint/Milestone deleted (
56)
- Sprint changed from Sprint 33 to Sprint 34
- Description updated (diff)
Removing /status/
from description because it is actually nested under /api/v3/
- Sprint changed from Sprint 34 to Sprint 35
- Status changed from NEW to ASSIGNED
- Assignee set to bmbouter
- Status changed from ASSIGNED to POST
- Status changed from POST to MODIFIED
- % Done changed from 0 to 100
- Sprint/Milestone set to 3.0.0
- Status changed from MODIFIED to CLOSED - CURRENTRELEASE
Also available in: Atom
PDF
Adds WSGI and Architecture Docs
This creates an Architecture and Scaling top level section of the docs. It also explains for each component how it can be scaled which mostly involves documenting how the WSGI application is laid out.
https://pulp.plan.io/issues/3132 closes #3132