OpenStack DNS As A Service (Designate)
Go to file
Jenkins 5dbe836e7b Merge "Add pretty_tox subunit wrapper" 2015-02-05 12:24:33 +00:00
contrib Switch to oslo.log 2015-01-21 21:39:16 +01:00
designate Merge "Allow Periodic Sync to be restricted to a subset of zones" 2015-02-05 12:05:10 +00:00
doc Remove the agent service and old-style backend tests 2014-12-15 16:09:26 +00:00
etc/designate Merge "Allow Periodic Sync to be restricted to a subset of zones" 2015-02-05 12:05:10 +00:00
rally-jobs Change SLA check for Designate 2014-12-24 18:22:42 +04:00
tools Add pretty_tox subunit wrapper 2015-01-30 20:25:08 +00:00
.coveragerc Add .coveragerc configuration file 2015-01-14 10:46:09 -08:00
.gitignore Add .coveragerc configuration file 2015-01-14 10:46:09 -08:00
.gitreview Update .gitreview for repository move 2014-06-28 16:52:03 +01:00
.testr.conf Update testr config for better logging 2014-07-26 15:11:58 -07:00
LICENSE Add LICENSE file. 2013-06-18 16:13:03 -04:00
MANIFEST.in Add pool_manager migrate.cfg in MANIFEST.in 2015-01-27 16:24:26 +08:00
README.md Update README.md doc build instructions 2015-01-13 16:41:28 -08:00
babel.cfg Setup for translation 2014-07-04 16:40:02 +02:00
designate.sublime-project Added policy checking for all all_tenent=True contexts 2014-08-12 21:50:33 +01:00
ipa-requirements.txt add support for FreeIPA backend - phase 5 - requirements 2014-05-07 17:16:12 -06:00
openstack-common.conf Switch to oslo.log 2015-01-21 21:39:16 +01:00
requirements.txt Updated from global requirements 2015-02-03 23:15:15 +00:00
setup.cfg The New Agent 2015-01-23 00:23:47 +00:00
setup.py Partial sync with global-requirements 2014-06-07 18:48:34 +01:00
test-requirements.txt Add pretty_tox subunit wrapper 2015-01-30 20:25:08 +00:00
tox.ini Merge "Add pretty_tox subunit wrapper" 2015-02-05 12:24:33 +00:00

README.md

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 git@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 restructred 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