e6d83dfcf7
Changes in python packaging tooling mean that the wsgi_scripts functionality via PBR may not longer function. This patch switches Designate from using the PBR wsgi_scripts method to using a new wsgi module that provides the same behavior as the generated wsgi scripts provided. A related devstack patch enables devstack to setup uWSGI to use the new module path instead of the generated wsgi scripts. This also aligns Designate to a new proposed OpenStack goal[1]. [1] https://review.opendev.org/c/openstack/governance/+/902807 In order to make the CI work, this patch was merged with: zuul: Drop centos9 and make grenade non-voting The requirements repo has dropped upper-constraints for python3.9, so the centos9-based jobs are no longer working on master, let's drop them. Also the grenade jobs are broken due to the referenced bug, make them temporarily non-voting, so that we can merge the fix[0] on master first, backport it, and then re-enable them. [0] https://review.opendev.org/c/openstack/designate/+/902846 Related-Bug: 2109577 Depends-On: https://review.opendev.org/c/openstack/devstack/+/902758 Change-Id: If90056ae1de4a6a3557fc870497e6233088bfb02
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 docsNow 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 py3Execute only backend tests
tox -e py3 -- unit.backendExecute only a single test
tox -e py3 -- unit.backend.test_pdns4.PDNS4BackendTestCase.test_create_zone_successContributing
Install the git-review package to make life easier
pip install git-reviewBranch, 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-reviewOther Information
- Free software: Apache license
- Documentation: https://docs.openstack.org/designate/latest/
- Release notes: https://docs.openstack.org/releasenotes/designate/
- Source: https://opendev.org/openstack/designate
- Bugs: https://bugs.launchpad.net/designate
- Blueprints: https://blueprints.launchpad.net/designate