Ansible role that installs Pulp 3 from PyPi or source and provides basic config.
The default administrative user for the Pulp application is: 'admin'
pulp_cache_dir
: Location of Pulp cache. Defaults to "/var/lib/pulp/tmp".pulp_config_dir
: Directory which will contain Pulp configuration files. Defaults to "/etc/pulp".pulp_default_admin_password
: Initial password for the Pulp admin. Required.pulp_install_dir
: Location of a virtual environment for Pulp and its Python dependencies. Defaults to "/usr/local/lib/pulp".pulp_install_plugins
: A nested dictionary of plugin configuration options. Defaults to "{}", which will not install any plugins.- Dictionary Key: The pip installable plugin name. This is defined in each
plugin's*
setup.py
. Required. source_dir
: Optional. Absolute path to the plugin source code. If present, plugin will be installed from source in editable mode.prereq_role
: Optional. Name of (or folder path to) Ansible role to run immediately before the venv is created. You will need to download it 1st (with ansible-galaxy.) Needed because many plugins will have OS dependencies in C. Seeprereq_pip_packages
also.
- Dictionary Key: The pip installable plugin name. This is defined in each
plugin's*
pulp_install_api_service
: Whether to create systemd service files for pulp-api. Defaults to "true".pulp_source_dir
: Optional. Absolute path to Pulp source code. If present, Pulp will be installed from source in editable mode.pulp_user
: User that owns and runs Pulp. Defaults to "pulp".pulp_user_id
: Integer value of uid for thepulp_user
. Defaults to nothing and uid is assigned by the system.pulp_group
: The group that thepulp_user
belongs to. Defaults topulp
.pulp_group_id
: Integer value of gid for thepulp_group
. Defaults to nothing and gid is assigned by the system.pulp_use_system_wide_pkgs
Use python system-wide packages. Defaults to "false".pulp_remote_user_environ_name
Optional. Set theREMOTE_USER_ENVIRON_NAME
setting for Pulp. This variable will be set as the value ofCONTENT_HOST
as the base path to build content URLs.pulp_api_bind
Interface and Port where Pulp Contentgunicorn
service will listen. Defaults to '127.0.0.1:24817'. This variable is the value used to render thepulp-api.service.j2
template passing to the--bind
parameter of thegunicorn
service.pulp_settings
: A nested dictionary that is used to add custom values to the user'ssetting.py
, which will override any default values set by pulpcore. The keys of this dictionary are variable names, and the values can be nested. Please see pulpcore configuration docs for documentation on the possible values.pulp_settings.secret_key
: Required. Pulp's Django applicationSECRET_KEY
.
epel_release_packages
: List of strings (package names, URLs) to pass toyum install
to ensure that "epel-release" is installed. Once the 1st string is found to be installed by yum, no further strings are attempted. Defaults to (on el7 for example): ["epel-release", "https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm"] Set to an empty list[]
if you wish to disable trying to install epel-release, such as if you manually add the EPEL repo via your own configuration or subscription-manager/katello. Also accepts a single string or empty string. Only affects CentOS/RHEL.rhel7_optional_repo
: List of possible names for the rhel7 optional repo to enable. Once the 1st name is enabled (or found to already be enabled), no further names are attempted. Defaults to ["rhui-rhel-7-server-rhui-optional-rpms", "rhel-7-server-optional-rpms", "rhel-7-workstation-optional-rpms"] Set to an empty list[]
if you wish to disable trying to enable the repo, such as if you manually add the optional repo via your own configuration or subscription-manager/katello. Also accepts a single string or empty string. Only affects RHEL7 (RHEL8 no longer has an optional repo.)
-
ansible_python_interpreter
: Required. Path to the Python interpreter. -
prereq_pip_packages
: Additional pip packages to install in the virtual environment before installing pulp or its content plugins. Defaults to an empty list, but aprereq_role
may append to it.
This role is required by the pulp-database
role and uses some variables from it.
pulp_settings_db_defaults
: See pulp-database README.
Each currently supported operating system has a matching file in the "vars" directory.
GPLv2
Pulp Team