OpenStack DNS As A Service (Designate)
Go to file
Zuul 13ca3954a0 Merge "Fix zone update when adding new Bind9 target to pool." 2022-03-10 01:25:33 +00:00
api-ref/source Merge "Fix API reference for list service statuses" 2022-02-18 02:49:58 +00:00
contrib Merge "Add template for testing review or branch" 2022-02-17 23:43:59 +00:00
designate Merge "Fix zone update when adding new Bind9 target to pool." 2022-03-10 01:25:33 +00:00
devstack Fix grenade job for mod_wsgi to uwsgi transition 2022-02-18 17:58:41 +00:00
doc Merge "Add CLI examples to user section" 2022-02-23 19:44:54 +00:00
etc/designate Integrate OSprofiler and Designate 2022-02-07 07:12:18 +00:00
playbooks Add fips jobs 2021-11-05 18:10:48 +00:00
rally-jobs Add validation to improve pep8 check for designate project 2017-11-20 12:26:16 +00:00
releasenotes Merge "Fix zone update when adding new Bind9 target to pool." 2022-03-10 01:25:33 +00:00
roles Update Zuul Jobs 2019-03-25 15:32:40 +00:00
tools Remove references to sys.version_info 2021-09-18 11:05:49 +08:00
.coveragerc Update .coveragerc after the removal of respective directory 2016-10-18 17:56:48 +05:30
.gitignore Remove testrepository 2018-07-11 17:44:40 +07:00
.gitreview OpenDev Migration Patch 2019-04-19 19:42:14 +00:00
.stestr.conf Switch to using stestr 2018-06-03 11:32:57 -04:00
.zuul.yaml Make CentOS 9 Stream job non-voting 2022-02-28 16:41:22 +00:00
CONTRIBUTING.rst Community Goal: Project PTL & Contrib Docs Update 2020-04-14 14:17:15 -06:00
LICENSE Add LICENSE file. 2013-06-18 16:13:03 -04:00
README.rst Moving to OFTC 2021-05-27 06:21:33 -06:00
designate.sublime-project Add __pycache__ to ST2 Ignore 2015-07-09 20:19:53 +01:00
ipa-requirements.txt add support for FreeIPA backend - phase 5 - requirements 2014-05-07 17:16:12 -06:00
lower-constraints.txt Integrate OSprofiler and Designate 2022-02-07 07:12:18 +00:00
requirements.txt Integrate OSprofiler and Designate 2022-02-07 07:12:18 +00:00
setup.cfg Updating python testing classifier as per Yoga testing runtime 2021-12-21 10:07:36 +08:00
setup.py Cleanup py27 support 2020-04-05 08:11:51 +02:00
test-requirements.txt Fix lower-constraints 2020-12-13 14:07:52 +01:00
tox.ini Add non-voting dnspython latest release unit test 2022-02-03 23:40:36 +00:00

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