OpenStack DNS As A Service (Designate)
b15245143d
Release notes are version independent, so remove version/release values. We've found that projects now require the service package to be installed in order to build release notes, and this is entirely due to the current convention of pulling in the version information. Release notes should not need installation in order to build, so this unnecessary version setting needs to be removed. This is needed for new release notes publishing, see I56909152975f731a9d2c21b2825b972195e48ee8 and the discussion starting at http://lists.openstack.org/pipermail/openstack-dev/2017-November/124480.html . Change-Id: Ia51fc308826127bf26a141a38bdbdf93bb318c52 |
||
---|---|---|
api-ref/source | ||
contrib | ||
designate | ||
devstack | ||
doc | ||
etc/designate | ||
rally-jobs | ||
releasenotes | ||
tools | ||
.coveragerc | ||
.gitignore | ||
.gitreview | ||
.testr.conf | ||
babel.cfg | ||
designate.sublime-project | ||
ipa-requirements.txt | ||
LICENSE | ||
README.rst | ||
requirements.txt | ||
setup.cfg | ||
setup.py | ||
test-requirements.txt | ||
tox.ini |
Team and repository tags
OpenStack Designate
Designate is an OpenStack project, providing DNSaaS.
IRC: #openstack-dns
Installation: https://docs.openstack.org/designate/latest/
Development
Designate follows the OpenStack Gerrit Workflow
Setup
Setup a working environment:
git clone https://github.com/openstack/designate.git
cd designate
virtualenv .venv
. .venv/bin/activate
pip install -r requirements.txt -r test-requirements.txt
python setup.py develop
Building Docs
To build the documentation from the restructured text source, do the following:
cd doc
pip install -r requirements.txt
sphinx-build source/ build/html/
now point your browser at html/index.html (the official documentation is published to docs.openstack.org by the maintainers.
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
Testing
Execute a single test using py27 (test is CentralServiceTest.test_count_domains)
tox -e py27 -- designate.tests.test_central.test_service.CentralServiceTest.test_count_zones_policy_check
- Free software: Apache license
- Documentation: https://docs.openstack.org/designate/latest/
- Source: https://git.openstack.org/cgit/openstack/designate
- Bugs: https://bugs.launchpad.net/designate