saltstack-formulas/bind-formula
1
0
Fork 0
mirror of https://github.com/saltstack-formulas/bind-formula.git synced 2025-04-17 10:10:26 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs(readme): fix headings [skip ci]

Browse source
This commit is contained in:
Imran Iqbal 2021-05-05 15:40:04 +01:00
parent 9833cb616c
commit 292b0232c1
No known key found for this signature in database
GPG key ID: 6D8629439D2B7819
1 changed files with 10 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
docs/README.rst
View file

@ -57,7 +57,7 @@ Install the bind package and start the bind service.
Manage the bind configuration file. Manage the bind configuration file.
Example Pillar Example Pillar
============== --------------
.. code:: yaml .. code:: yaml
@ -94,10 +94,10 @@ Example Pillar
See *pillar.example* for a more complete example. See *pillar.example* for a more complete example.
Management of zone files Management of zone files
======================== ------------------------
`named.conf.local` `named.conf.local`
------------------ ^^^^^^^^^^^^^^^^^^
<zone> entries in `named.conf.local` will point to the file declared in <zone> entries in `named.conf.local` will point to the file declared in
@ -105,7 +105,7 @@ Management of zone files
* `bind:available_zones:<zone>:file` * `bind:available_zones:<zone>:file`
zone files zone files
---------- ^^^^^^^^^^
The `config.sls` state will iterate on `bind:available_zones` and manage The `config.sls` state will iterate on `bind:available_zones` and manage
<zone> files for each <zone> that has bind:available_zones:<zone>:file` <zone> files for each <zone> that has bind:available_zones:<zone>:file`
@ -118,21 +118,21 @@ declared.
that will be **sourced** by the formula. that will be **sourced** by the formula.
Using Views Using Views
----------- ^^^^^^^^^^^
Using views introduces some restrictions by the BIND server in that once you have views defined, ALL of your zones have to be served via a view. You cannot have any zones defined outside of a view. Using views introduces some restrictions by the BIND server in that once you have views defined, ALL of your zones have to be served via a view. You cannot have any zones defined outside of a view.
If you want multiple views to serve the same zone but with different record sets, follow the example in pillar-with-views.example to set this up. The key to this is the 'file' argument in the view configuration that allows you to set the view's configured_zone to a zone that you define underneath 'available_zones'. Without specifying this 'file' argument, your views cannot serve the same zone; they will instead serve a zone that matches the name of the view. If you want multiple views to serve the same zone but with different record sets, follow the example in pillar-with-views.example to set this up. The key to this is the 'file' argument in the view configuration that allows you to set the view's configured_zone to a zone that you define underneath 'available_zones'. Without specifying this 'file' argument, your views cannot serve the same zone; they will instead serve a zone that matches the name of the view.
External zone files External zone files
------------------- ^^^^^^^^^^^^^^^^^^^
To use an external tool to manage the <zone> file, simply declare the location To use an external tool to manage the <zone> file, simply declare the location
of the zone file in `bind:configured_zones:<zone>:file` and **don't** add any of the zone file in `bind:configured_zones:<zone>:file` and **don't** add any
entry for the <zone> in `bind:available_zones` entry for the <zone> in `bind:available_zones`
DNSSEC DNSSEC
====== ------
The `bind` formula currently support two ways to enable DNSSEC: The `bind` formula currently support two ways to enable DNSSEC:
@ -187,12 +187,12 @@ On the slave server :
- 192.168.1.1 - 192.168.1.1
Notes Notes
===== -----
* When using views all zones must be configured in views! * When using views all zones must be configured in views!
Salt Compatibility Salt Compatibility
================== ------------------
Tested with: Tested with:
@ -200,7 +200,7 @@ Tested with:
* 2018.3.x * 2018.3.x
OS Compatibility OS Compatibility
================ ----------------
Tested with: Tested with: