OpenStack DNS As A Service (Designate)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Jenkins 1f6163a50d Merge "Enable v2/recordsets API for tempest plugin" 2 years ago
api-ref/source Fix typo 2 years ago
contrib Add Wily and Xenial devstack VMs 2 years ago
designate Support binding to IPv6 addresses in TCP sockets 2 years ago
devstack Merge "Enable v2/recordsets API for tempest plugin" 2 years ago
doc Merge "Docs Update" 2 years ago
etc/designate Add Knot DNS backend 2 years ago
functionaltests Remove test cases which are moved to designate_tempest_plugin 2 years ago
rally-jobs Grammar mistakes have been corrected 3 years ago
releasenotes Add Knot DNS backend 2 years ago
tools Removed old tooling for ks CLI 3 years ago
.coveragerc Change ignore-errors to ignore_errors 3 years ago
.gitignore Start Designate API-Ref style documentation 2 years ago
.gitreview Update .gitreview for repository move 4 years ago
.testr.conf Add functional tox env 3 years ago
LICENSE Add LICENSE file. 5 years ago
README.rst Update README to RST 3 years ago
babel.cfg Setup for translation 4 years ago
designate.sublime-project Add __pycache__ to ST2 Ignore 3 years ago
ipa-requirements.txt add support for FreeIPA backend - phase 5 - requirements 5 years ago
openstack-common.conf Switch to oslo.reports 3 years ago
requirements.txt Updated from global requirements 2 years ago
setup.cfg Add Knot DNS backend 2 years ago
setup.py Updated from global requirements 3 years ago
test-requirements.txt Updated from global requirements 2 years ago
tests-py3.txt Fix rrset serialization, improve mdns tests 2 years ago
tox.ini Fix gate trying to use u-c for api-ref 2 years ago

README.rst

OpenStack Designate

Designate is an OpenStack project, providing DNSaaS.

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 Docs

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.CentralServiceTest.test_count_zones_policy_check