Skip to content


Install, configure, and set the state of the pulp API service.

This role depends on the pulp_common role, see it for many more variables on configuring pulp_api.

Role Variables#

  • pulp_api_bind: Interface and Port where Pulp Content gunicorn service will listen. One can specify a unix socket path instead (recommended value is 'unix:/var/run/pulpcore-api/pulpcore-api.sock'). Defaults to ''.
  • pulp_api_workers: Number of gunicorn processes for handling Pulp API requests. Defaults to 1.
  • pulp_token_auth_key: Location of the openssl private key (in pem format) to use for token authentication. If not specified, a new key wil be generated. (Only generated if one doesn't exist.)

Shared variables#

This role depends upon the the pulp_common role, which in turn depends on on pulp_repos. You should consult pulp_common in particular for variables that effectively control the behavior of this role.

This role also utilizes some of the pulp_common role's variables in its logic:

  • pulp_certs_dir: Path where to generate or drop the key for authentication token. Defaults to '{{ pulp_config_dir }}/certs' .
  • pulp_config_dir
  • pulp_group
  • pulp_install_dir
  • pulp_ld_library_path: An optional LD_LIBRARY_PATH environment variable for the pulpcore-api systemd process
  • pulp_settings_file
  • pulp_user

Last update: 2022-07-25