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.
 
 
 
Zuul 0483a53321 Merge "Fix configuration leak in unit tests" 2 weeks ago
api-ref/source Add option to force delete zone-files in delete API. 1 month ago
contrib Remove netaddr module requirement 4 months ago
designate Merge "Fix configuration leak in unit tests" 2 weeks ago
devstack Add Ubuntu 22.04 CI support 1 month ago
doc Remove unicode 2 months ago
etc/designate Sync rootwrap.conf from oslo.rootwrap 4 months ago
playbooks Add fips jobs 1 year ago
rally-jobs Add validation to improve pep8 check for designate project 5 years ago
releasenotes Merge "Add option to force delete zone-files in delete API." 2 weeks ago
roles Merge "Stop double compressing pdns logs" 7 months ago
tools Remove references to sys.version_info 1 year ago
.coveragerc Update .coveragerc after the removal of respective directory 6 years ago
.gitignore Remove testrepository 4 years ago
.gitreview OpenDev Migration Patch 4 years ago
.stestr.conf Switch to using stestr 5 years ago
.zuul.yaml Migrate Designate jobs to run on Ubuntu 22.04 (Jammy) 1 month ago
CONTRIBUTING.rst Community Goal: Project PTL & Contrib Docs Update 3 years ago
LICENSE Add LICENSE file. 10 years ago
README.rst Moving to OFTC 2 years ago
designate.sublime-project Add __pycache__ to ST2 Ignore 8 years ago
ipa-requirements.txt add support for FreeIPA backend - phase 5 - requirements 9 years ago
requirements.txt Fix minimum versions in requirements.txt 2 months ago
setup.cfg Update metadata in setup.cfg 3 weeks ago
setup.py Cleanup py27 support 3 years ago
test-requirements.txt Bump hacking version 6 months ago
tox.ini Increase minimum acceptable test coverage 2 months ago

README.rst

Team and repository tags

image

OpenStack Designate

Designate is an OpenStack project, providing DNSaaS.

IRC: #openstack-dns @ oftc

Installation: https://docs.openstack.org/designate/latest/

API

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:

Development

Designate follows the OpenStack Gerrit Workflow

Setup

Setup a working environment:

git clone https://opendev.org/openstack/designate
cd designate
virtualenv .venv
. .venv/bin/activate
pip install -r requirements.txt -r test-requirements.txt
pip install -e .

Building Docs

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

tox -e docs

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

Testing

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

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

Other Information