pulp / pulpcore

Pulp 3 pulpcore package https://pypi.org/project/pulpcore/
GNU General Public License v2.0
284 stars 111 forks source link

out of date pypi install documentation #2574

Open jgrammen-agilitypr opened 2 years ago

jgrammen-agilitypr commented 2 years ago

https://docs.pulpproject.org/pulpcore/installation/instructions.html#pypi-installation

pulp 3.19.0

  1. there is warning about 3.19.0 being unsupported
    You are looking at the docs for an un[supported version](https://pulpproject.org/docs/) of Pulp. Consider switching to a supported version

    but there is no way to "switch" to a supported version of the docs

  2. https://docs.pulpproject.org/pulpcore/installation/instructions.html#systemd mentions pulpcore-resource-manager.service in step except resource-manger was removed in a earlier verison
jgrammen-agilitypr commented 2 years ago

adding additional doc issue:

https://docs.pulpproject.org/pulpcore/en/master/nightly/installation/instructions.html#user-and-database-configuration

mentions a "provided server.yaml" which doesn't exist

jgrammen-agilitypr commented 2 years ago

dynaconf list, is not runnable (https://docs.pulpproject.org/pulpcore/en/master/nightly/configuration/viewing.html)

pulp@pulp:/usr/local/lib/python3.8/dist-packages/pulpcore$ dynaconf --instance pulpcore.app.settings list
Usage: dynaconf [OPTIONS] COMMAND [ARGS]...

Error: module 'pulpcore.app' has no attribute 'settings'

and the migration command doesnt run

pulp@pulp:/usr/local/lib/python3.8/dist-packages/pulpcore$ pulpcore-manager migrate --noinput
Traceback (most recent call last):
  File "/usr/local/bin/pulpcore-manager", line 8, in <module>
    sys.exit(manage())
  File "/usr/local/lib/python3.8/dist-packages/pulpcore/app/manage.py", line 11, in manage
    execute_from_command_line(sys.argv)
  File "/usr/local/lib/python3.8/dist-packages/django/core/management/__init__.py", line 419, in execute_from_command_line
    utility.execute()
  File "/usr/local/lib/python3.8/dist-packages/django/core/management/__init__.py", line 363, in execute
    settings.INSTALLED_APPS
  File "/usr/local/lib/python3.8/dist-packages/django/conf/__init__.py", line 82, in __getattr__
    self._setup(name)
  File "/usr/local/lib/python3.8/dist-packages/django/conf/__init__.py", line 69, in _setup
    self._wrapped = Settings(settings_module)
  File "/usr/local/lib/python3.8/dist-packages/django/conf/__init__.py", line 170, in __init__
    mod = importlib.import_module(self.SETTINGS_MODULE)
  File "/usr/lib/python3.8/importlib/__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1014, in _gcd_import
  File "<frozen importlib._bootstrap>", line 991, in _find_and_load
  File "<frozen importlib._bootstrap>", line 975, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 671, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 848, in exec_module
  File "<frozen importlib._bootstrap>", line 219, in _call_with_frames_removed
  File "/usr/local/lib/python3.8/dist-packages/pulpcore/app/settings.py", line 355, in <module>
    settings = DjangoDynaconf(
  File "/usr/local/lib/python3.8/dist-packages/dynaconf/contrib/django_dynaconf_v2.py", line 81, in load
    lazy_settings.populate_obj(django_settings_module)
  File "/usr/local/lib/python3.8/dist-packages/dynaconf/base.py", line 113, in __getattr__
    self._setup()
  File "/usr/local/lib/python3.8/dist-packages/dynaconf/base.py", line 163, in _setup
    self._wrapped = Settings(
  File "/usr/local/lib/python3.8/dist-packages/dynaconf/base.py", line 238, in __init__
    self.validators.validate(
  File "/usr/local/lib/python3.8/dist-packages/dynaconf/validator.py", line 441, in validate
    validator.validate(
  File "/usr/local/lib/python3.8/dist-packages/dynaconf/validator.py", line 207, in validate
    self._validate_items(
  File "/usr/local/lib/python3.8/dist-packages/dynaconf/validator.py", line 247, in _validate_items
    raise ValidationError(
dynaconf.validator.ValidationError: CONTENT_ORIGIN is a required setting but it was not configured. This may be caused by invalid read permissions of the settings file. Note that CONTENT_ORIGIN is set by the installer automatically.

even though content origin is set in /etc/pulp/settings.yaml

 cat /etc/pulp/settings.yaml
---
default:
  content_origin: http://pulp.test.internal
  db_encryption_key: /etc/pulp/certs/database_fields.symmetric.key
  DATABASES:
      default:
        NAME: 'pulp'
        USER: 'pulp'
        PASSWORD: 'password'
        ENGINE: django.db.backends.postgresql