OpenStack DNS As A Service (Designate)
Go to file
Michael Johnson 5809159e4a Add clean_zonefile to BIND9 pool.yaml doc
This patch adds an example of the "clean_zonefile" option in the BIND9 targets in the pools.yaml file. The option has existed in the code, but was not documented in any way.
It also enables this feature in the bind9 devstack plugin for testing and to reduce the storage utilization during test runs.

Change-Id: I70b92b400cfeb059d1a1889ffa72621e0011d8c6
2023-10-24 03:13:18 +00:00
api-ref/source Implement sharing of zones 2023-02-14 01:54:15 +00:00
contrib Remove deprecated designate-agent 2023-10-04 14:39:57 +00:00
designate Remove deprecated designate-agent 2023-10-04 14:39:57 +00:00
devstack Add clean_zonefile to BIND9 pool.yaml doc 2023-10-24 03:13:18 +00:00
doc Add clean_zonefile to BIND9 pool.yaml doc 2023-10-24 03:13:18 +00:00
etc/designate Add middleware to limit request body size to api-paste 2023-09-19 20:36:09 +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 "Remove deprecated designate-agent" 2023-10-14 15:31:05 +00:00
roles Merge "Stop double compressing pdns logs" 2022-05-12 19:00:02 +00:00
tools Remove references to sys.version_info 2021-09-18 11:05:49 +08:00
.coveragerc Omit hacking from cover 2023-05-25 20:24:49 -07:00
.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 Always run all tests when changing default config 2023-10-05 09:10:32 -07: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 Update Unit Test README 2023-06-04 20:48:31 -07:00
bindep.txt Replace blockdiag with graphviz 2023-07-28 20:00:07 +00:00
designate.sublime-project Add __pycache__ to ST2 Ignore 2015-07-09 20:19:53 +01:00
requirements.txt Use SDK instead of neutronclient 2023-03-25 06:06:30 +00:00
setup.cfg Remove deprecated designate-agent 2023-10-04 14:39:57 +00:00
setup.py Cleanup py27 support 2020-04-05 08:11:51 +02:00
test-requirements.txt Bump hacking version 2022-06-16 09:31:18 +02:00
tox.ini Increase minimum test coverage to 90% 2023-08-02 16:51:37 +02: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 py3

Execute only backend tests

tox -e py3 -- unit.backend

Execute only a single test

tox -e py3 -- 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