Task #7229
closed
publish plugin documentation at docs.pulpproject.org
0%
Description
We currently host 'pulpcore' documentation at the root of docs.pulproject.org. We want to publish documentation for additional pulp plugins under that domain. We want each plugin to be stored in the directory corresponding to its name.
docs.pulpproject.org/pulpcore/
docs.pulpproject.org/pulp_rpm/
docs.pulpproject.org/pulp_file/
docs.pulpproject.org/pulp_container/
docs.pulpproject.org/pulp_deb/
docs.pulpproject.org/pulp_gem/
docs.pulpproject.org/pulp_npm/
docs.pulpproject.org/pulp_maven/
docs.pulpproject.org/pulp_python/
docs.pulpproject.org/pulp_ansible/
The root of the domain should forward users to docs.pulpproject.org/pulpcore/.
Each plugin should use its own user (named the same as the directory). Each user should only have the ability to write to its plugin directory. Each plugin is going to use rsync (and a unique private key) to publish the documentation to its directory.
Related issues
Updated by bmbouter over 4 years ago
- Description updated (diff)
Renamed "project" to plugin for clarity.
Updated by duck over 4 years ago
Here is a proposal: https://github.com/pulp/pulp-infra-ansible/pull/9
Please provide all the component<->SSH key associations so I can fill-in the Ansible rules with it.
The redirection is currently commented-out until the core is synced properly. Beware the username is going to change.
Once all the components sync properly I'll remove the old user and cleanup the vhost's top directory.
Tell me what you think about it.
Updated by duck over 4 years ago
I am not allowed to change the status of this issue to reflect it's now WIP, could someone do that please?
Updated by dkliban@redhat.com over 4 years ago
- Status changed from NEW to ASSIGNED
- Assignee set to duck
Updated by duck over 4 years ago
I updated the PR with all the keys and fixed E208 spotted by ansible-lint.
Added by dkliban@redhat.com over 4 years ago
Updated by pulpbot over 4 years ago
- Status changed from ASSIGNED to POST
Updated by pulpbot over 4 years ago
Added by dkliban@redhat.com over 4 years ago
Revision 01d82ed7 | View on GitHub
Changes the username and rsync path for doc publishing
Updated by pulpbot over 4 years ago
Added by dkliban@redhat.com over 4 years ago
Revision 521dbcdb | View on GitHub
Updates the location of where docs are published on pulpproject.org
Updated by pulpbot over 4 years ago
Updated by duck over 4 years ago
The core is published and old URLs are redirected.
Components are not yet synced, let's check this too.
I's like to cleanup the old sync account, may I remove it now? As for the files in the root directory of the vhost, using the same exceptions as the redirection, I guess I can remove everything?
Also while looking at it I realized there is a _sources subdirectory;. If the goal of this link is to encourage people to contribute I would suggest linking to GH instead of embedding the sources.
Updated by dkliban@redhat.com over 4 years ago
duck wrote:
The core is published and old URLs are redirected.
Components are not yet synced, let's check this too.
I's like to cleanup the old sync account, may I remove it now? As for the files in the root directory of the vhost, using the same exceptions as the redirection, I guess I can remove everything?
You can remove the old doc_builder account. We are no longer using it.
You can remove everything from the root of docs.pulpproject.org vhost using the same exceptions as redirection.
Also while looking at it I realized there is a
_sourcessubdirectory;. If the goal of this link is to encourage people to contribute I would suggest linking to GH instead of embedding the sources.
This gets generated when we build our docs. We don't ever point users to these files. We always tell users to submit docs changes via github.
Updated by duck over 4 years ago
I did the cleanup.
As for _sources, your doc builder, or the template used, creates a View page source link top-right on all pages.
Updated by pulpbot over 4 years ago
Updated by pulpbot over 4 years ago
Updated by pulpbot over 4 years ago
Added by dkliban@redhat.com over 4 years ago
Revision dc9e98c5 | View on GitHub
Changes docs publishing to docs.pulpproject.org/pulpcore/
Added by dkliban@redhat.com over 4 years ago
Revision 4080241e | View on GitHub
Changes the username and rsync path for doc publishing
Added by dkliban@redhat.com over 4 years ago
Revision cb29910b | View on GitHub
Updates the location of where docs are published on pulpproject.org
Updated by dkliban@redhat.com over 4 years ago
- Status changed from POST to MODIFIED
I am setting this issue to MODIFIED because the pulpcore docs will now be published to the new location. If we find any issues with plugins, I will open a new ticket.
Updated by pulpbot over 4 years ago
- Status changed from MODIFIED to CLOSED - CURRENTRELEASE
Updated by dkliban@redhat.com over 4 years ago
- Status changed from CLOSED - CURRENTRELEASE to POST
- Sprint/Milestone deleted (
3.6.1)
Setting back to POST just so I can merge the changes to plugin_template repo.
Added by dkliban@redhat.com over 4 years ago
Revision c4a3443e | View on GitHub
Adds support for publishing docs to pulpproject.org
Updated by daviddavis about 4 years ago
- Has duplicate Task #5542: Have Travis publish our plugin docs added
Updated by fao89 almost 3 years ago
- Status changed from POST to CLOSED - WORKSFORME
.
Changes docs publishing to docs.pulpproject.org/pulpcore/
re: #7229 https://pulp.plan.io/issues/7229