Project

Profile

Help

Network maintenance. Planio will be observing two scheduled maintenance windows this Tuesday, March 2 and Wednesday, March 3 from 02:00 UTC until 06:00 UTC each in order to perform maintenance on access routers in our primary datacenter. Your account might observe short downtimes during these periods up to several minutes at a time.

Task #7750

Add Installation Layout on the filesystem to the installation guide

Added by ekohl 4 months ago. Updated 25 days ago.

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

100%

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

Description

The installation guide should provide information about the layout of /var/lib/pulp and /etc/pulp/. Something similar to what the foreman-installer offers in this area[0].

[0] https://github.com/theforeman/puppet-pulpcore#installation-layout

Associated revisions

Revision a69eb16b View on GitHub
Added by mdellweg 3 months ago

Add filesystem layout to deployment docs

fixes #7750 https://pulp.plan.io/issues/7705

History

#1 Updated by mdepaulo@redhat.com 4 months ago

So the pulp team decided on pulpcore_static because:

  1. It's similar to the static directory we use for Pulp 2. "pulpcore" is our standard Pulp 3 prefix for conflicting file/services/etc names.
  2. It's meant for static assets served by the webserver rather than by whitenoise in the Pulp 3 processes. Currently Apache or nginx, potentially other webservers that don't have that exact setting. Potentially some other web / cloud architecture mechanism.
  3. I think there are alternatives to the "DocumentRoot" config setting we may use at some point, particularly if the webserver is to be shared with other applications.

DocRoot is more specific to the current implementation and makes perfect sense for someone who is versed in Apache or Nginx. But I still prefer pulpcore_static, which is more future-proof in terms of naming, and backwards referential (Pulp 2 "static").

#2 Updated by ekohl 4 months ago

Nginx calls it root instead of DocumentRoot, but that's fairly similar. As such, it's closer than just "pulpcore_static". However, if that's what you choose then we'll follow.

It would be very useful if the documentation (for example https://docs.pulpproject.org/pulpcore/installation/index.html) would document the recommended directory layout. For now I wrote it myself (https://github.com/theforeman/puppet-pulpcore#installation-layout) but for anyone looking to learn more that would be a good start.

#3 Updated by dkliban@redhat.com 4 months ago

Changing the name of the directory would require our installer to provide an upgrade path for this change. At this time we don't have the capacity to work on such a feature in the installer. Let's all use /var/lib/pulp/pulpcore_static/.

#4 Updated by dkliban@redhat.com 4 months ago

  • Tracker changed from Issue to Task
  • Status changed from NEW to CLOSED - COMPLETE
  • % Done set to 0
  • Severity deleted (2. Medium)
  • Triaged deleted (No)

#5 Updated by dkliban@redhat.com 4 months ago

  • Subject changed from Determine the recommended document root to Add Installation Layout on the filesystem to the installation guide
  • Description updated (diff)
  • Status changed from CLOSED - COMPLETE to NEW
  • Tags Documentation added

Re-opened as a documentation task and updated the description.

#6 Updated by mdellweg 4 months ago

  • Status changed from NEW to ASSIGNED
  • Assignee set to mdellweg

#7 Updated by pulpbot 4 months ago

  • Status changed from ASSIGNED to POST

#8 Updated by mdellweg 3 months ago

  • Status changed from POST to MODIFIED
  • % Done changed from 0 to 100

#9 Updated by ttereshc 25 days ago

  • Sprint/Milestone set to 3.10.0

#10 Updated by pulpbot 25 days ago

  • Status changed from MODIFIED to CLOSED - CURRENTRELEASE

Please register to edit this issue

Also available in: Atom PDF