Skip to content

OpenStack DNS As A Service (Designate). Mirror of code maintained at opendev.org.

License

Notifications You must be signed in to change notification settings

openstack/designate

Folders and files

NameName
Last commit message
Last commit date
Sep 25, 2024
Jun 30, 2024
Mar 7, 2025
Apr 1, 2025
Feb 11, 2025
Nov 9, 2024
Nov 5, 2021
Nov 20, 2017
Mar 18, 2025
May 12, 2022
Jan 17, 2024
Nov 8, 2023
Nov 9, 2024
Apr 19, 2019
Jun 3, 2018
Feb 11, 2025
Apr 14, 2020
Jun 18, 2013
Jun 5, 2023
Jul 28, 2023
Jul 9, 2015
Nov 19, 2024
Nov 9, 2024
Apr 5, 2020
Jun 1, 2024
Jun 1, 2024

Repository files navigation

Team and repository tags

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