RETIRED, further work has moved to Debian project infrastructure
8ed288e313
as of mitaka, the infra team won't have the resources available to reasonably test py26, also the oslo team is dropping py26 support from their libraries. sine we rely on oslo for a lot of our work, and depend on infra for our CI, we should drop py26 support too. Change-Id: I4aeba7269ddb465ac61f851f5b5d2ab1b91882e4 Related-Bug: #1519510 |
||
---|---|---|
contrib | ||
designate | ||
devstack | ||
doc | ||
etc/designate | ||
functionaltests | ||
rally-jobs | ||
releasenotes | ||
tools | ||
.coveragerc | ||
.gitignore | ||
.gitreview | ||
.testr.conf | ||
babel.cfg | ||
designate.sublime-project | ||
ipa-requirements.txt | ||
LICENSE | ||
MANIFEST.in | ||
openstack-common.conf | ||
README.md | ||
requirements.txt | ||
setup.cfg | ||
setup.py | ||
test-requirements.txt | ||
tox.ini |
Introduction
Designate is an OpenStack inspired DNSaaS.
Docs: http://docs.openstack.org/developer/designate and some below for now. Bugs / Blueprints: http://launchpad.net/designate
IRC: #openstack-dns
Installation: http://docs.openstack.org/developer/designate/getting-started.html
Development
Designate follows the OpenStack Gerrit Workflow
Setup
Setup a working environment:
git clone https://github.com/openstack/designate.git
cd designate
virtualenv .venv
. .venv/bin/activate
pip install -r requirements.txt -r test-requirements.txt
python setup.py develop
Building the documentation
To build the documentation from the restructured text source, do the following:
cd doc
pip install -r requirements.txt
sphinx-build source/ build/html/
now point your browser at html/index.html (the official documentation is published to docs.openstack.org by the maintainers.
Contributing
Install the git-review package to make life easier
pip install git-review
Branch, work, & submit:
# cut a new branch, tracking master
git checkout --track -b bug/id origin/master
# work work work
git add stuff
git commit
# rebase/squash to a single commit before submitting
git rebase -i
# submit
git-review
Testing
Execute a single test using py27 (test is CentralServiceTest.test_count_domains)
tox -e py27 -- designate/tests/test_central/test_service.py:CentralServiceTest.test_count_domains