Developer Setup

To ease developer setup, we have Pulplift which is based on the Forklift project and utilizes Ansible roles and playbooks to provide supported Vagrant boxes that are more consistent with the user experience.

Clone the ‘pulplift’, ‘pulp’, and ‘pulp-file’ (or any plugins that you’ll be working on) repos into the same directory so that they are peers.

Navigate into the pulplift directory. Run the script which will clone the ‘forklift’ and ‘ansible-pulp3’ repos:


The parent directory of ‘pulplift’ is going to be mounted into the vagrant box at /home/vagrant/devel. Any plugins that need to be installed should be added to the pulplift/ansible-pulp3/source-install.yml playbook. The paths to the source of the plugins should start with /home/vagrant/devel/. For example:

    app_label: "pulp_python"
    source_dir: "/home/vagrant/devel/pulp_python"
    app_label: "pulp_file"
    source_dir: "/home/vagrant/devel/pulp_file"

Once this is complete, take a look at available boxes with ‘vagrant status’ and then spin up your chosen environment:

vagrant up pulp3-source-fedora28

Activate your virtual environment:

workon pulp

Happy developing!