Project

Profile

Help

Task #7229

closed

publish plugin documentation at docs.pulpproject.org

Added by dkliban@redhat.com over 3 years ago. Updated about 2 years ago.

Status:
CLOSED - WORKSFORME
Priority:
Normal
Assignee:
Category:
-
Sprint/Milestone:
-
Start date:
Due date:
% Done:

0%

Estimated time:
Platform Release:
Groomed:
No
Sprint Candidate:
No
Tags:
Sprint:
Quarter:

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

Has duplicate Pulp - Task #5542: Have Travis publish our plugin docsCLOSED - DUPLICATE

Actions
Actions #1

Updated by bmbouter over 3 years ago

  • Description updated (diff)

Renamed "project" to plugin for clarity.

Actions #2

Updated by dkliban@redhat.com over 3 years ago

  • Description updated (diff)
Actions #3

Updated by dkliban@redhat.com over 3 years ago

  • Description updated (diff)
Actions #4

Updated by duck over 3 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.

Actions #5

Updated by duck over 3 years ago

I am not allowed to change the status of this issue to reflect it's now WIP, could someone do that please?

Actions #6

Updated by dkliban@redhat.com over 3 years ago

  • Status changed from NEW to ASSIGNED
  • Assignee set to duck
Actions #7

Updated by duck over 3 years ago

I updated the PR with all the keys and fixed E208 spotted by ansible-lint.

Added by dkliban@redhat.com over 3 years ago

Revision c775bd5f | View on GitHub

Changes docs publishing to docs.pulpproject.org/pulpcore/

re: #7229 https://pulp.plan.io/issues/7229

Actions #8

Updated by pulpbot over 3 years ago

  • Status changed from ASSIGNED to POST

Added by dkliban@redhat.com over 3 years ago

Revision 01d82ed7 | View on GitHub

Changes the username and rsync path for doc publishing

re: #7229 https://pulp.plan.io/issues/7229

Added by dkliban@redhat.com over 3 years ago

Revision 521dbcdb | View on GitHub

Updates the location of where docs are published on pulpproject.org

re: #7229 https://pulp.plan.io/issues/7229

Actions #12

Updated by duck over 3 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.

Actions #13

Updated by dkliban@redhat.com over 3 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 _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.

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.

Actions #14

Updated by duck over 3 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.

Added by dkliban@redhat.com over 3 years ago

Revision dc9e98c5 | View on GitHub

Changes docs publishing to docs.pulpproject.org/pulpcore/

re: #7229 https://pulp.plan.io/issues/7229

Added by dkliban@redhat.com over 3 years ago

Revision 4080241e | View on GitHub

Changes the username and rsync path for doc publishing

re: #7229 https://pulp.plan.io/issues/7229

Added by dkliban@redhat.com over 3 years ago

Revision cb29910b | View on GitHub

Updates the location of where docs are published on pulpproject.org

re: #7229 https://pulp.plan.io/issues/7229

Actions #18

Updated by dkliban@redhat.com over 3 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.

Actions #19

Updated by dkliban@redhat.com over 3 years ago

  • Sprint/Milestone set to 3.6.1
Actions #20

Updated by pulpbot over 3 years ago

  • Status changed from MODIFIED to CLOSED - CURRENTRELEASE
Actions #21

Updated by dkliban@redhat.com over 3 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 3 years ago

Revision c4a3443e | View on GitHub

Adds support for publishing docs to pulpproject.org

re: #7229 https://pulp.plan.io/issues/7229

Actions #22

Updated by daviddavis over 3 years ago

  • Has duplicate Task #5542: Have Travis publish our plugin docs added
Actions #23

Updated by fao89 about 2 years ago

  • Status changed from POST to CLOSED - WORKSFORME

Also available in: Atom PDF