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.
OpenStack Proposal Bot cb531e41e6 Imported Translations from Zanata 17 hours ago
api-ref/source Switch to newer openstackdocstheme and reno versions 1 month ago
contrib Update hacking for Python3 3 months ago
designate Merge "Stop to use the __future__ module." 1 day ago
devstack Fix uwsgi path 4 weeks ago
doc Remove broken and outdated related doc page 1 week ago
etc/designate Implement create/delete zone for Akamai v2 API 5 months ago
playbooks Use Tempest 'all' tox env 5 months ago
rally-jobs Add validation to improve pep8 check for designate project 2 years ago
releasenotes Imported Translations from Zanata 17 hours ago
roles Update Zuul Jobs 1 year ago
tools Stop to use the __future__ module. 1 month ago
.coveragerc Update .coveragerc after the removal of respective directory 3 years ago
.gitignore Remove testrepository 2 years ago
.gitreview OpenDev Migration Patch 1 year ago
.stestr.conf Switch to using stestr 2 years ago
.zuul.yaml Add Python3 victoria unit tests 2 months ago
CONTRIBUTING.rst Community Goal: Project PTL & Contrib Docs Update 2 months ago
LICENSE Add LICENSE file. 7 years ago
README.rst Updated Readme 9 months ago
babel.cfg Setup for translation 6 years ago
designate.sublime-project Add __pycache__ to ST2 Ignore 5 years ago
ipa-requirements.txt add support for FreeIPA backend - phase 5 - requirements 6 years ago
lower-constraints.txt Use unittest.mock instead of third party mock 1 month ago
requirements.txt Cap jsonschema 3.2.0 as the minimal version 1 month ago
setup.cfg Add py38 package metadata 1 month ago Cleanup py27 support 3 months ago
test-requirements.txt Use unittest.mock instead of third party mock 1 month ago
tox.ini Stop setting version specific basepython binaries 3 months ago


Team and repository tags


OpenStack Designate

Designate is an OpenStack project, providing DNSaaS.

IRC: #openstack-dns @ freenode



To learn how to use Designate's API, consult the documentation available online at:

For more information on OpenStack APIs, SDKs and CLIs in general, refer to:


Designate follows the OpenStack Gerrit Workflow


Setup a working environment:

Building Docs

To build the documentation from the restructured text source, do the following:

Now point your browser at doc/build/html/index.html (the official documentation is published to by the maintainers.


Execute all unit tests

tox -e py36

Execute only backend tests

tox -e py36 -- unit.backend

Execute only a single test

tox -e py36 -- unit.backend.test_pdns4.PDNS4BackendTestCase.test_create_zone_success


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

Other Information