400 Commits

Author SHA1 Message Date
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
Zuul
5dcf504c70 Merge "Add top-level CLI reference page in docs" 2018-10-15 21:19:35 +00:00
Matt Riedemann
7c0ebd310c Add top-level CLI reference page in docs
This creates the top-level cli/ reference in the
docs and moves the designate-manage docs to that
CLI reference. A redirect is added for sending
old links to the new home for the designate-manage.html
page.

We'll build on this to add docs for the new
designate-status upgrade check command.

Change-Id: Ic05bc343131651edc7379976fdc877cfb286e310
2018-10-15 12:18:01 -04:00
Zuul
2a72cdd58b Merge "Remove -u root as mysql is executed with root user" 2018-09-24 16:34:41 +00:00
Zuul
f54317f99e Merge "Add docs for project-id verification feature" 2018-09-19 13:16:37 +00:00
Pavlo Shchelokovskyy
bdbb1ee5aa Improve configuration guide
add example command line to generate policy file and add links to
configuration docs (they are currently reside in the Admin Guide).

Change-Id: Ie5a24ef99a7d272693702a39aa679c7ba0c07655
2018-09-04 12:35:58 +03:00
Pavlo Shchelokovskyy
f3c3dec7da Add docs for project-id verification feature
Change-Id: Ibe98d50be578b35cb92c70d703c23dd27b192787
Related-Bug: #1760822
2018-08-21 17:19:11 +00:00
zhang.lei
180a7611f8 Remove -u root as mysql is executed with root user
As openstack installation guides suggest to run mysql with root shell
user, mysql will not ask for password, so the "-u root -p" is useless.

Change-Id: I245b8969ec58de91b7d21267bbdf4273d572c8d2
Related-Bug: #1785025
2018-08-19 14:21:57 +00:00
Zuul
e1c6d98cca Merge "[Docs] Fix the incorrect designate service name" 2018-06-14 09:26:28 +00:00
Ben Nemec
66cfef57ad Document --record instead of --records
Per the cli, --records is deprecated and --record should be used
instead.

Change-Id: I00f2562342480a1eb9bdbba519e28c69dffe6d0e
2018-06-13 15:47:29 +00:00
zhang.lei
283b15b789 [Docs] Fix the incorrect designate service name
Change-Id: Ic28fedae673b12d7659eb492e2497ab9238695f8
2018-06-12 07:50:12 +00:00
Nguyen Van Trung
063fb8661b Allow to check pep8 along with D000
This patch only setup package dependency which named Pygments
for this test. Pygments also exist item in lower-contraints.txt
which does not setup along with tox env.

Change-Id: I1a75150b7fd813a4126716b898a55f35c64c5ec6
2018-05-23 11:01:57 +07:00
Zuul
2ac404cde3 Merge "Replace Chinese punctuation with English punctuation" 2018-05-20 23:41:40 +00:00
Nguyen Van Trung
c7f0db5e68 Fix contents render for notification.rst
old:

   .. literalinclude::

       ../../../designate/tests/resources/sample_notifications/neutron/port.delete.start.json

new:

    {
       "priority" : "INFO",
       "message_id" : "95ecdca3-967f-40aa-9469-d9fccc91d64b",
       "event_type" : "port.delete.start",
       "_context_roles" : [
          "Member"
       ],
       "_context_tenant_id" : "c97027dd880d4c129ae7a4ba7edade05",
       "timestamp" : "2012-11-16 12:56:17.155860",
       "_context_is_admin" : false,
       "_context_user_id" : "4ce5c085e09a478ea4edcd667a92df78",
       "payload" : {
          "port_id" : "bfdcb007-f68d-46bd-8150-abcae9fb3af6"
       },
       "_context_timestamp" : "2012-11-16 12:56:17.154672",
       "publisher_id" : "network.svc02.os.lan",
       "_context_read_deleted" : "no"
    }

Change-Id: I659ffcb5fcb7032a54670602a6534218e1e153fa
2018-05-18 09:49:40 +07:00
inspurericzhang
b59e0c16d9 Replace Chinese punctuation with English punctuation
Curly quotes(Chinese punctuation) usually input from Chinese input method.
When read from english context, it makes some confusion.

Change-Id: I9b9c8015394578d52c3a55839b84b4f64fb0a5c4
2018-05-17 15:32:14 +08:00
wangqi
08aa2d4816 fix a typo: s/extention/extension
Change-Id: Ife244edb3addf28416cf6b1a2bb891161ef35100
2018-04-23 08:44:39 +00:00
caoyuan
bba6022af9 Update auth_uri option to www_authenticate_uri
Option auth_uri from group keystone_authtoken is deprecated[1].
Use option www_authenticate_uri from group keystone_authtoken.

[1]https://review.openstack.org/#/c/508522/

Change-Id: I80b505feb611af8a95ac19f2808c73069e2a33e5
2018-04-11 22:23:35 +08:00
Erik Olof Gunnar Andersson
8bc3693c19 Replace deprecated LOG.warn with LOG.warning
LOG.warn is deprecated in Python 3 [1] . But it still used in a few places, non-deprecated LOG.warning should be used instead.

Note: If we are using logger from oslo.log, warn is still valid [2], but I agree we can switch to LOG.warning.

[1]https://docs.python.org/3/library/logging.html#logging.warning
[2]https://github.com/openstack/oslo.log/blob/master/oslo_log/log.py#L85

Change-Id: Ibbcc287815cbc06162a13448c2dabcb0748e4e32
Closes-Bug: #1508442
2018-04-03 14:28:01 -07:00
OpenStack Proposal Bot
7a2adab56a Updated from global requirements
Change-Id: I9ffc7367b696a1f2eb63954d0d865a645869fa9a
2018-03-28 03:25:55 +00:00
melissaml
794dea3817 Follow the new PTI for document build
For compliance with the Project Testing Interface as described in:
https://governance.openstack.org/tc/reference/project-testing-interface.html

For more detials information, please refer to:
http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html

Change-Id: Ic7dad29922af2efed2188f3215f364719f0e19ae
2018-03-27 10:30:57 +08:00
Erik Olof Gunnar Andersson
6ad30a39e6 Remove translation of log messages
* Removed all log translation.
* Always lazy-load logging.
* Fixed broken log lines and updated tests.

Logs should no longer be translated (starting with Pike)[1].

Also, according to OpenStack Guideline[2], logged string message should be
interpolated by the logger.

[1]: http://lists.openstack.org/pipermail/openstack-dev/2017-March/thread.html#113365
[2]: https://docs.openstack.org/oslo.i18n/latest/user/guidelines.html#adding-variables-to-log-messages

Change-Id: I07825694f173a8bebd7d62ade089c38d3c666283
2018-03-14 12:54:05 -07:00
Zuul
65104a1a91 Merge "Remove empty files" 2018-02-24 12:13:44 +00:00
Nguyen Hung Phuong
41a6c860c0 Remove empty files
doc/source/_static/designate-docs.css
is empty file. We probably should delete it.

Change-Id: I9d3d3e4c42e841abc9599eba81a3b6d7d9cb1a2f
2018-02-22 17:47:24 +07:00
Thomas Goirand
ed69c37962 Fix unicode not define in doc with py3
Under Python 3.6 in Debian Sid, I couldn't build the sphinx doc, and this
patch fixes it. It replaces unicode by six.text_type.

Change-Id: I538f10ef297fb45cb82e47f5bcb86ed214a062b0
2018-02-18 11:52:13 +01:00
zhangdebo
f8e5c0af8e Correct link address in docs
Link address for "DNS Server Driver Support Matrix" is out of date,
so correct it.

Change-Id: I2584ca26b3ab24e3ac44db2e5a1d5ecb3599117e
2018-01-29 14:22:04 +08:00
Graham Hayes
c318106c01 Remove v1 API
This completes the long awaited removal of the V1 API.

Change-Id: I30c8a5e8569b1b86286c5e3cb07856c06ebe5803
2018-01-11 14:13:43 +00:00
Zuul
f83addc827 Merge "Docs Refactor" 2017-12-18 16:49:30 +00:00
Graham Hayes
26d6298b97 Remove unneeded requirements file
Need to make requirements-check non-voting in order for this to pass,
will undo that afterwards.

Change-Id: Ibc77ea864503e63f73be0f1c41e07bfe8ea3dcae
2017-12-07 14:12:04 +00:00
Graham Hayes
3955f474a5
Docs Refactor
* Move backend docs to admin guide
* Add oslo.config sphinx extention
* Add HA guide
* Update drivers to log driver grade

Change-Id: I4a364a0d1a0656f26d3a4c3b7baad7e43cddcb16
2017-12-05 21:06:18 +00:00
Jens Harbott
ca7da3dcd8 Update installation docs
- Replace keystone_authtoken section with v3 style parameters
- Update Ubuntu doc to reference current LTS release
- Update Ubuntu doc to use systemctl

Change-Id: Ic1dedb04b08e09eda3d7772846eadeb7aa22fbb2
Closes-Bug: 1734635
2017-12-04 06:44:15 +00:00
Nguyen Van Trung
154d12114f Add validation to improve pep8 check for designate project
This PS will help project avoid pep8 some issues for *.rst
in whole project.

Co-authored-By: Hoang Trung Hieu <hieuht@vn.fujitsu.com>
Change-Id: I7a01863b1aa0bcf999be6e6e2261ab35530c196a
2017-11-20 12:26:16 +00:00