Gitiles
Code Review Sign In
gerrit.mcp.mirantis.com / salt-formulas / bind / 379fff0b356a94e80d7f997ab8f6c14d36c1a03c / . / README.rst
blob: a59b3b567b4bcb4ac30e65b6e5ab5771ae58aa72 [file] [log] [blame]
Ales Komarek882ac7b2014-07-14 10:47:56 +0200[diff] [blame]1
Ales Komarek77dbf032017-01-29 21:46:05 +0100[diff] [blame]2============
3Bind formula
4============
Ales Komarek882ac7b2014-07-14 10:47:56 +0200[diff] [blame]5
Ales Komarek77dbf032017-01-29 21:46:05 +0100[diff] [blame]6BIND is open source software that enables you to publish your Domain Name System (DNS) information on the Internet, and to resolve DNS queries for your users. The name BIND stands for “Berkeley Internet Name Domain”, because the software originated in the early 1980s at the University of California at Berkeley.
7
8Sample pillars
9==============
10
11.. code-block:: yaml
Ales Komarek882ac7b2014-07-14 10:47:56 +0200[diff] [blame]12
Ales Komarek712343b2014-09-22 11:36:17 +0200[diff] [blame]13 bind:
14 server:
15 enabled: true
Filip Pytloun5299d072016-10-06 11:23:21 +0200[diff] [blame]16 key:
17 keyname:
18 secret: xyz
19 algorithm: hmac-sha512
Filip Pytloun57435b22016-10-06 11:30:16 +0200[diff] [blame]20 server:
21 8.8.8.8:
22 keys:
23 - keyname
Ales Komarek712343b2014-09-22 11:36:17 +0200[diff] [blame]24 zone:
25 sub.domain.com:
Filip Pytloun52aa75d2016-02-26 17:14:54 +0100[diff] [blame]26 ttl: 86400
27 root: "hostmaster@domain.com"
Ales Komarek712343b2014-09-22 11:36:17 +0200[diff] [blame]28 type: master
Ales Komarekce71bf92014-09-30 11:35:30 +0200[diff] [blame]29 records:
30 - name: @
31 type: A
32 ttl: 7200
33 value: 192.168.0.5
Ales Komarek712343b2014-09-22 11:36:17 +0200[diff] [blame]34 1.168.192.in-addr.arpa:
35 type: master
Ales Komarekce71bf92014-09-30 11:35:30 +0200[diff] [blame]36 notify: false
Filip Pytlounfaf8bbc2016-02-26 16:32:20 +0100[diff] [blame]37 slave.domain.com:
38 type: slave
39 notify: true
40 masters:
Filip Pytloun52aa75d2016-02-26 17:14:54 +0100[diff] [blame]41 # Masters must be specified by IP address
42 - 8.8.8.8
43 - 8.8.4.4
Filip Pytlounfaf8bbc2016-02-26 16:32:20 +0100[diff] [blame]44 dnssec:
45 enabled: true
46 # Don't hide version
47 version: true
48 # Allow recursion, better don't on public dns servers
49 recursion:
50 hosts:
51 - localhost
Ales Komarekfbfa1682014-09-22 11:31:14 +0200[diff] [blame]52
Ales Komarek77dbf032017-01-29 21:46:05 +0100[diff] [blame]53Read more
54=========
Ales Komarek2bf43322014-09-22 13:03:41 +0200[diff] [blame]55
Ales Komarekce71bf92014-09-30 11:35:30 +0200[diff] [blame]56* https://github.com/theforeman/puppet-dns
Filip Pytlounfaf8bbc2016-02-26 16:32:20 +0100[diff] [blame]57* https://help.ubuntu.com/community/BIND9ServerHowto
Ales Komarek77dbf032017-01-29 21:46:05 +0100[diff] [blame]58* https://www.isc.org/downloads/bind/
Filip Pytloun379fff02017-02-02 13:02:03 +0100[diff] [blame^]59
60Documentation and Bugs
61======================
62
63To learn how to install and update salt-formulas, consult the documentation
64available online at:
65
66 http://salt-formulas.readthedocs.io/
67
68In the unfortunate event that bugs are discovered, they should be reported to
69the appropriate issue tracker. Use Github issue tracker for specific salt
70formula:
71
72 https://github.com/salt-formulas/salt-formula-bind/issues
73
74For feature requests, bug reports or blueprints affecting entire ecosystem,
75use Launchpad salt-formulas project:
76
77 https://launchpad.net/salt-formulas
78
79You can also join salt-formulas-users team and subscribe to mailing list:
80
81 https://launchpad.net/~salt-formulas-users
82
83Developers wishing to work on the salt-formulas projects should always base
84their work on master branch and submit pull request against specific formula.
85
86 https://github.com/salt-formulas/salt-formula-bind
87
88Any questions or feedback is always welcome so feel free to join our IRC
89channel:
90
91 #salt-formulas @ irc.freenode.net