Contributing

Setting up a development environment in an OpenStack VM using cloud-init

The following cloud-config script can be passed as a –user-data argument to nova boot. This will result in a fully operational DLRN environment to hack on.

Setting up a development environment manually

Installing prerequisites:

$ sudo yum install mock rpm-build git createrepo python-virtualenv git-hg python-pip
$ sudo systemctl start httpd

Add the user you intend to run as to the mock group:

$ sudo usermod -a -G mock $USER

Checkout the Source code and install a virtualenv:

$ git clone https://github.com/openstack-packages/DLRN.git
$ cd DLRN
$ virtualenv .venv
$ source .venv/bin/activate
$ pip install -r requirements.txt
$ pip install -r test-requirements.txt
$ python setup.py develop

Submitting pull requests

Pull requests submitted through GitHub will be ignored. They should be sent to GerritHub instead, using git-review. Once submitted, they will show up here:

Generating the documentation

Please note that the RDO Packaging Documentation also contains instructions for DLRN.

The documentation is generated with Sphinx. To generate the documentation, go to the documentation directory and run the make file:

$ cd DLRN/doc/source
$ make html

The output will be in DLRN/doc/build/html