430 Commits

Author SHA1 Message Date
michaeltchapman
6e8080e82d Remove broken and outdated related doc page
The ubuntu PPA was for havana and there appears to be no
more modern equivalent

The nova and neutron designate plugins both link to github
repositories that are now deleted.

The chef cookbook, debian packages and example plugin have no
updates in the last 7 years

The bug and blueprint links are current and are already on the
getting-started page

The git repo has been added to the getting started page as that
was the only remaining link

Change-Id: I5d93ffdbeac54a396fc34d13a96636b23c5845e1
2020-06-29 14:51:32 +10:00
Zuul
9b1bb026ad Merge "Add examples using the OpenStack CLI" 2020-06-02 17:40:04 +00:00
Nicolas Bock
cbae0a8b9e
Add examples using the OpenStack CLI
In case a user wants to use the CLI add the appropriate invocations.

Change-Id: I49272ea9631dc142e80f7a2376fc1f2c3c9e0a61
Signed-off-by: Nicolas Bock <nicolas.bock@canonical.com>
2020-06-01 11:23:39 -06:00
Zuul
b9c4e9962e Merge "Fix some spelling" 2020-06-01 16:04:04 +00:00
Nicolas Bock
92ae4a9456
Fix some spelling
Change-Id: Iaf11303ac43879ffaee0782a0910280e932e7d04
Signed-off-by: Nicolas Bock <nicolas.bock@canonical.com>
2020-06-01 09:11:07 -06:00
Zuul
28515ea876 Merge "Update contributor docs" 2020-05-25 16:25:58 +00:00
Andreas Jaeger
663e420643 Switch to newer openstackdocstheme and reno versions
Switch to openstackdocstheme 2.2.0 and reno 3.1.0 versions. Using
these versions will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems

Update Sphinx version as well.

Set openstackdocs_pdf_link to link to PDF file. Note that
the link to the published document only works on docs.openstack.org
where the PDF file is placed in the top-level html directory. The
site-preview places the PDF in a pdf directory.

Set openstackdocs_auto_name to use 'project' as name.

Change pygments_style to 'native' since old theme version always used
'native' and the theme now respects the setting and using 'sphinx' can
lead to some strange rendering.

Remove docs requirements from lower-constraints, they are not needed
during install or test but only for docs building.

openstackdocstheme renames some variables, so follow the renames
before the next release removes them. A couple of variables are also
not needed anymore, remove them.

Add openstackdocstheme options to api-ref.

Change-Id: I0cf71327ca5d9da1d88a826225374c8801849c36
2020-05-20 08:13:38 +02:00
hamza alqtaishat
12d50c7f5b Adding the option to set the zone quota to unlimited
by assigning negative value for the resource like -1

Change-Id: Iaeca2be8b38075e3e7e8f79621b4b41cbe9934f7
Closes-Bug: #1876198
2020-05-14 08:25:18 +00:00
Dr. Jens Harbott
577641e61e Update contributor docs
- Drop reference to weekly meeting
- Use https when possible
- Update comment about devstack plugin
- Need to use Ubuntu 18.04 or newer
- Change deprecated option in example

Change-Id: Icdff59fb24fde99b02b9d5e85e3b6d17d5f3434e
2020-05-14 06:28:26 +00:00
Nicolas Bock
161c6d5a5d
Community Goal: Project PTL & Contrib Docs Update
This patch standardizes the CONTRIBUTING.rst file and adds information
from the required doc/source/contributor/contributing.rst.

Change-Id: I4a47ef22c70c6f6b225ea779227627d7f3078f4e
Story: #2007236
Task: #38520
Signed-off-by: Nicolas Bock <nicolas.bock@canonical.com>
2020-04-14 14:17:15 -06:00
Andreas Jaeger
21f94dea86 Cleanup docs building
* Switch to newer openstackdocstheme version and remove settings
  that are default now

Change-Id: Iec8791077aa7f1cb8edfa64235fb718a98aaba90
2020-02-23 17:33:27 +01:00
Graham Hayes
ce7a4a8886
Update the Akamai DNS Driver matrix information
* Mark Akamai v2 as untested
* Mark Akamai eDNS as known broken due to the API being removed
* Add basic docs for Akamai v2

Change-Id: I4f6c6c1c96251bfc4f7ad3bb6b0bd2025397fa03
Signed-off-by: Graham Hayes <gr@ham.ie>
2020-02-13 15:11:54 +00:00
Ghanshyam Mann
cdac0fc2f9 [ussuri][goal] Drop python 2.7 support and testing
OpenStack is dropping the py2.7 support in ussuri cycle.

Designate is ready with python 3 and ok to drop the
python 2.7 support.

Complete discussion & schedule can be found in
- http://lists.openstack.org/pipermail/openstack-discuss/2019-October/010142.html
- https://etherpad.openstack.org/p/drop-python2-support

Ussuri Communtiy-wide goal:
https://governance.openstack.org/tc/goals/selected/ussuri/drop-py27.html

Depends-On: https://review.opendev.org/#/c/693631/
Change-Id: I5a5bdc859f87f82097b95b2ebb31edb6e9b72b3a
2019-12-13 18:49:14 +00:00
zhouhenglc
d708ff588b designate-manage pool update --dry-run not should pass argument
--dry-run and --delete should be switchs.
now --dry_run acts as key value pair. users do not know what is behind
--dry-run. and now whatever the value is acceptable. this is unreasonable.

Closes-bug: #1847393

Change-Id: Ia6ab93395deb95173e443f9d3ea77dd52edfcf2c
2019-10-11 17:51:57 +08:00
Zuul
031908c004 Merge "Removed deprecated powerdns 3 driver" 2019-09-25 18:29:48 +00:00
Zuul
5c232b2181 Merge "Removed deprecated pool-manager implementation" 2019-09-25 18:29:47 +00:00
Erik Olof Gunnar Andersson
5814793806 Set enable_host_header in documentation
This is better practice and we should recommend
this value set in the install guides.

Host headers makes use of request host_url provided
by Flask, instead of relying on the hard-coded url in
the configuration.

Change-Id: I9fbb71acd063d2034190e773f69f7a80275b2f3c
2019-09-24 12:58:46 -07:00
Erik Olof Gunnar Andersson
660eacbce4 Removed deprecated powerdns 3 driver
This driver was replaced by the pdns 4 driver
many cycles ago and is being permanently removed.

Change-Id: Ic34cee5fde21f838b6dd6b54fcdd767ec8b0bc18
2019-09-24 04:26:19 -07:00
Erik Olof Gunnar Andersson
52ad1c4c13 Removed deprecated pool-manager implementation
The pool-manager has been deprecated since Newton and
is now being removed with the Train release.

Change-Id: Ib258043d492bb25e1c061d765b40885317c73804
2019-09-24 11:10:54 +00:00
Zuul
23f6a79aef Merge "Add missing RabbitMQ configuration to install guides" 2019-09-17 08:39:55 +00:00
Erik Olof Gunnar Andersson
88a8ba5d8b Add missing RabbitMQ configuration to install guides
Change-Id: Id7972ca5600a202bc885bf5cdb528b9e335e558d
2019-09-13 10:53:21 -07:00
Thomas Bechtold
ceaba7d067 Build man pages for the commands that are documented
Running "sphinx-build -b man doc/source doc/build/man" allows the
build of man pages which are useful when working from the command
line.

Change-Id: Ia9e2bb2cc9d68bea71a19ff8296bbf9bd3cd95a4
2019-09-12 13:23:30 +02:00
Zuul
aed5dcdb68 Merge "Standardizing install guides" 2019-09-11 11:33:45 +00:00
Zuul
41b45f9e89 Merge "Add pdf-docs env to tox.ini" 2019-09-09 12:31:08 +00:00
Nicolas Bock
437cbf05ad Add pdf-docs env to tox.ini
- Enable PDF documentation. Based on [1].
- Enable table of contents generation for pdf
- Removed literalinclude of designate.conf [2]
- Removed illegal character (a literal ESC)
- Fix incorrect column count in backends summary section
- Replace nodes.line() with nodes.paragraph()

[1] https://review.opendev.org/601659
[2] https://github.com/sphinx-doc/sphinx/issues/3099

Change-Id: Ie454f8f9ebc8e36347ce33b22f2e6da0257fe4e0
Signed-off-by: Nicolas Bock <nicolas.bock@suse.com>
2019-09-07 09:26:57 +00:00
Erik Olof Gunnar Andersson
005ecc87aa Standardizing install guides
Change-Id: Ifee7ad3e69b1e40d97ee620a567f1a18773de534
2019-09-05 19:31:49 -07:00
Zuul
e080b14422 Merge "Fixed broken kolla install link" 2019-09-06 00:02:59 +00:00
Erik Olof Gunnar Andersson
7cf35ad94f Updated install guide
* Added memcached to keystone section.
* Removed worker configuration as this is now default.

Change-Id: I809d16d119c1d03ac650e6f9328b72ce5c9d19ff
2019-09-05 09:44:07 -07:00
Erik Olof Gunnar Andersson
3429014cdb Fixed error in install guide
There is an error in the service:api section
of the documentation. Quotas and reports are
valid admin extensions and not v2 extensions.

In addition we also never actually enabled
the admin api.

Change-Id: I240a274d9129612596fe06798e8b29bd9159bd03
2019-09-04 19:49:00 +00:00
Erik Olof Gunnar Andersson
c2ff6b9b99 Fixed broken kolla install link
Change-Id: I6e16eb50841b200cbdd0fc2ce7a157cf9bdfae9d
2019-09-02 15:22:18 -07:00
Andreas Jaeger
e1ea40444e Docs: Fix broken links and make more robust
The following links are broken:
https://docs.openstack.org/designate/latest/contributor/sourcedoc/backends/djbdns_agent.html
https://docs.openstack.org/designate/latest/contributor/sourcedoc/backends/gdnsd_agent.html
https://docs.openstack.org/designate/latest/contributor/sourcedoc/backends/knot2_agent.html

Fix those.

Also, use in some places internal links instead of external ones to
make linking more robust against renames of files.

Change-Id: Ia4724f03e9bba1a6f05a8290b0eb31790ed9c715
2019-08-25 07:24:57 +02:00
Erik Olof Gunnar Andersson
d160f36451 Fix missing _static folder breaking gate
Change-Id: I91e7528292a07e86d6a570dfd5f4f177852fe0d8
2019-08-23 15:38:02 -07:00
Alexandra Settle
c53b1684a8 Fixing 404 link
Did not specify between 2.8 and 2.7, went with
generic documentation link for ease of future use.

Change-Id: I43c5f71c9b335055ee8691566eb662fdb27eeba8
backport: stein rocky
2019-08-10 03:29:45 +00:00
pengyuesheng
7ea9255539 Blacklist sphinx 2.1.0 (autodoc bug)
See https://github.com/sphinx-doc/sphinx/issues/6440 for upstream details

Change-Id: Iddb4a46ab1c22e84212932342b80c19194adcf3e
2019-08-01 17:22:01 +08:00
Andreas Jaeger
ad32f7a15d Update api-ref location
The api documentation is now published on docs.openstack.org instead
of developer.openstack.org. Update all links that are changed to the
new location.

Note that redirects will be set up as well but let's point now to the
new location.

For details, see:
http://lists.openstack.org/pipermail/openstack-discuss/2019-July/007828.html

Change-Id: Ibd4ed1a1e282f0088467a6fcafe44b1dad46ed5f
2019-07-22 18:36:31 +02:00
Erik Olof Gunnar Andersson
c95f0445ec Fixed issue with documentation breaking CI
> Could not lex literal_block as "guess". Highlighting skipped.

Changes guess to none (no highlighting) to resolve this.

Change-Id: Iffe1846f0fff4e9f1c980fcbeed6f71f941eeaf9
2019-06-16 16:30:23 -07:00
Erik Olof Gunnar Andersson
a53c3daf16 Moved most configuration into designate.conf
Based upon the established conf paradigm used in Nova,
this patch moves most of the configuration to a
central location. Making config a lot easier to
manage, as well a lot easier to locate.

There is still some configuration listed in classes,
that I would like to eventually move to
designate.conf as well, but to lower complexity not
all config was moved.

General changes
* Centrelized most configuration under designate.conf.
* Cleaned up configuration.
* Simplified config generation.
* Renamed generated config to designate.conf.sample.

Previously broken
* xfr_timeout now in the appropriate section.
* memcached_servers now in the appropriate section.

Previously missing from sample config
* allowed_remote_exmods listed in sample config.
* backend:akamai section listed in sample config.
* backend:dynect section listed in sample config.
* backend:infoblox section listed in sample config.

blueprint centralize-config-designate

Change-Id: I3be68bf294157631a9bac128df0841220020de96
2019-05-28 23:54:00 +00:00
Zuul
4809fb17a7 Merge "Replace git.openstack.org URLs with opendev.org URLs" 2019-05-20 04:18:22 +00:00
Zuul
74e46c784f Merge "Update Driver statuses" 2019-05-20 04:18:21 +00:00
Adam Harwell
af51a84477 Cap to sphinx 2.0.0 on Python 2.7
Sphinx 2.0.0 dropped Python 2.7 support. This is aligned with
Change-Id If558f184c959e4b63b56dec3ca1571d1034cfe5c in requirements
project.

Change-Id: I01467293fffbcf45ee9b311731f5d8699040215a
Co-Authored-By: Carlos Goncalves <cgoncalves@redhat.com>
2019-05-14 16:10:18 -07:00
ZhongShengping
5d0408c719 Replace git.openstack.org URLs with opendev.org URLs
Thorough replacement of git.openstack.org URLs with their opendev.org
counterparts.

Change-Id: I5cfdd0c3e813f1cb6f72087fdb3ee3957b6e9ea7
2019-04-24 08:47:23 +08:00
Graham Hayes
3fbd9dea9d
Update Driver statuses
Change-Id: Iac78b8668bcdca34bf354d6feab3e9547ba2c71f
Signed-off-by: Graham Hayes <gr@ham.ie>
2019-04-01 15:03:09 +01:00
Zuul
33ca0b8789 Merge "Allow pdns4 backend to select tsigkey" 2019-03-25 20:44:34 +00:00
Graham Hayes
7a1ba8ee9b Allow pdns4 backend to select tsigkey
Allow a new config item in pools.yaml to set the pdns tsigkey to use for
AFXR queries.

Change-Id: Ibb4fb604957286c6edfe85f72321f199eb3167a7
Closes-Bug: #1820089
Signed-off-by: Graham Hayes <gr@ham.ie>
2019-03-22 09:11:41 +00:00
jacky06
fa3bc77967 Update json module to jsonutils
1. oslo project provide jsonutils, and designate use it in many place[1],
this PS to update the remained json module to oslo jsonutils for
consistency.
2. fix typos for rst file

[1]: https://github.com/openstack/designate/search?q=jsonutils&unscoped_q=jsonutils

Change-Id: Ib030b8a6e1369aa4ac7449a759580c4fcce247f7
2019-03-21 11:13:24 +08:00
Zuul
f97df023b2 Merge "Add designate-status command for upgrade checks" 2019-01-04 20:04:38 +00:00
Ben Nemec
1842802de4 Add designate-status command for upgrade checks
This checks for duplicate entries in the service_statuses table
which will be an error after change
I307a8f7dd8b8a83effa447a846db3288efa32dba.

Related-Bug: 1768824

Story: 2003657
Task: 26127

Change-Id: Ie0350b034f0eb03749138aadd0951d30073214c0
Co-authored-by: Doug Hellmann <doug@doughellmann.com>
2018-12-07 21:53:17 +00:00
Tytus Kurek
c0b54602a4
CAA DNS records
This patchset adds support for DNS CAA (Certification Authority
Authorization) Resource Record which is described in RFC 6844
(https://tools.ietf.org/html/rfc6844)

Change-Id: If9619096f1706d1123895b63b9129b9ffd4fb320
Closes-Bug: 1787552
2018-11-07 16:08:01 +00:00
Tytus Kurek
44d9c02c7c
NAPTR DNS records
This patchset adds support for DNS NAPTR (Naming Authority
Pointer) Resource Record which is described in RFC 2915
(https://tools.ietf.org/html/rfc2915)

Change-Id: Ic7d26a6c653ce46e67438e983476782edd6ec890
Closes-Bug: 1779850
2018-11-06 15:59:04 +00:00
Sean McGinnis
1479c91737 Update sphinx extension logging
Sphinx 1.6 deprecated using the application object to perform logging
and it will be removed in the upcoming 2.0 release. This updates our
extensions to use the recommended sphinx.util.logging instead.

Change-Id: I0b4d0d66ad60ff8e9b2d7de70d9858bd6ca5efa6
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>
2018-10-16 14:40:18 -05:00