Project

Profile

Help

Issue #8552

Issue #8477: As a new Pulp user, I would like well-described getting started information about using the Pulp installer

pulp_installer docs needs a better explanation of variables

Added by mdepaulo@redhat.com 25 days ago. Updated 24 days ago.

Status:
NEW
Priority:
Normal
Category:
Installer
Sprint/Milestone:
-
Start date:
Due date:
Estimated time:
Severity:
2. Medium
Version:
Platform Release:
OS:
Triaged:
Yes
Groomed:
No
Sprint Candidate:
No
Tags:
Documentation
Sprint:
Quarter:

Description

mcorr: The next section is titled Variables https://pulp-installer.readthedocs.io/en/latest/#variables. Nowhere does it tell users why this is the second topic in the Installer guide. I propose we change this to "Customizing your installation to suit your environment" and give a list of popular and known changes that you can pass through to the Ansible installer via the variables. In this way, the user has been inspired to think about possible options they might need.

mikedep333: I suggest we make this an entire page. It should list:

  1. Note on how Ansible lets you specify variables in multiple ways, and how we use files/playbooks in the example.
  2. Explanation of customization variables (like pulp_install_plugins) vs accommodating IT environments variables (like firewall)
  3. Move the "Recommended Workflows for Pulpcore & Plugin Versioning" section to it.
  4. List the most commonly used vars, with some examples
  5. Reference the roles for more info.
  6. Clarify pulp_settings vs other vars. And that users using the installer should only set pulp-settings via the installer.

History

#1 Updated by mdepaulo@redhat.com 24 days ago

  • Description updated (diff)

#2 Updated by mdepaulo@redhat.com 24 days ago

  • Description updated (diff)

#3 Updated by mdepaulo@redhat.com 24 days ago

  • Triaged changed from No to Yes

Please register to edit this issue

Also available in: Atom PDF