open-consul/website/source/docs
Pierre Souchay 42f250fa53 Added SOA configuration for DNS settings. (#4714)
This will allow to fine TUNE SOA settings sent by Consul in DNS responses,
for instance to be able to control negative ttl.

Will fix: https://github.com/hashicorp/consul/issues/4713

# Example

Override all settings:

* min_ttl: 0 => 60s
* retry: 600 (10m) => 300s (5 minutes),
* expire: 86400 (24h) => 43200 (12h)
* refresh: 3600 (1h) => 1800 (30 minutes)

```
consul agent -dev -hcl 'dns_config={soa={min_ttl=60,retry=300,expire=43200,refresh=1800}}'
```

Result:
```
dig +multiline @localhost -p 8600 service.consul

; <<>> DiG 9.12.1 <<>> +multiline @localhost -p 8600 service.consul
; (2 servers found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NXDOMAIN, id: 36557
;; flags: qr aa rd; QUERY: 1, ANSWER: 0, AUTHORITY: 1, ADDITIONAL: 1
;; WARNING: recursion requested but not available

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 4096
;; QUESTION SECTION:
;service.consul.		IN A

;; AUTHORITY SECTION:
consul.			0 IN SOA ns.consul. hostmaster.consul. (
				1537959133 ; serial
				1800       ; refresh (30 minutes)
				300        ; retry (5 minutes)
				43200      ; expire (12 hours)
				60         ; minimum (1 minute)
				)

;; Query time: 4 msec
;; SERVER: 127.0.0.1#8600(127.0.0.1)
;; WHEN: Wed Sep 26 12:52:13 CEST 2018
;; MSG SIZE  rcvd: 93
```
2018-10-10 15:50:56 -04:00
..
agent Added SOA configuration for DNS settings. (#4714) 2018-10-10 15:50:56 -04:00
commands Update the snapshot agent documentation(#4758) 2018-10-05 13:55:06 -04:00
connect Add Proxy Upstreams to Service Definition (#4639) 2018-10-10 16:55:34 +01:00
enterprise Update snapshot agent docs to include s3-endpoint (#4652) 2018-09-11 16:32:31 +01:00
guides Added SOA configuration for DNS settings. (#4714) 2018-10-10 15:50:56 -04:00
install Update index.html.md 2018-05-04 12:46:24 -05:00
internals Support Agent Caching for Service Discovery Results (#4541) 2018-10-10 16:55:34 +01:00
platform/k8s website: address PR feedback 2018-10-09 09:30:37 -07:00
compatibility.html.md fix a couple html errors (#4456) 2018-07-26 16:30:24 -07:00
faq.html.md Remove all mention of Atlas, even in deprecated changelogs 2018-08-03 10:51:18 -07:00
index.html.md website: rename *.markdown to *.md 2017-05-17 20:25:45 +02:00
upgrade-specific.html.md Remove all mention of Atlas, even in deprecated changelogs 2018-08-03 10:51:18 -07:00
upgrading.html.md Better information and advices for upgrade to 1.0.7+ 2018-03-02 09:08:00 +01:00