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.

Get the Source

It is assumed that any Pulp project repositories are cloned into one directory. As long as Ansible has read and write permissions, it doesn’t matter where your development directory is.

You will need pulp/pulpcore-plugin and pulp/pulpcore at a minimum:

$ git clone https://github.com/pulp/pulpcore-plugin.git
$ git clone https://github.com/pulp/pulpcore.git

Both of these repositories are for Pulp 3 only, development is done agains the master branch of each.

Additionally, you will need at least one plugin.:

$ git clone https://github.com/pulp/pulp_file.git

The current base branch on this repository is the master branch.

Warning

It is important to ensure that your repositories are all checked out to compatible versions. Check the setup.py of each repo see the version it provides, and the versions it requires.

Installation

We recommened using pulplift for developer installations. Follow the instructions in the README.md.

It is also possible to use the Ansible roles directly, if you prefer not to use Vagrant.