open-consul/website/source/docs/agent
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
..
basics.html.md adds link to agent config options from basic.html 2018-05-28 12:47:14 +05:30
checks.html.md docs: Update links to ttl health check endpoints. (#4208) 2018-07-26 16:14:44 -07:00
cloud-auto-join.html.md website: document k8s go-discover (#4666) 2018-09-13 10:12:27 -04:00
dns.html.md Implementation of Weights Data structures (#4468) 2018-09-07 15:30:47 +01:00
encryption.html.md update encryption doc and add guide for creating certificates (#4238) 2018-06-18 15:25:35 -04:00
options.html.md Added SOA configuration for DNS settings. (#4714) 2018-10-10 15:50:56 -04:00
rpc.html.md website: rename *.markdown to *.md 2017-05-17 20:25:45 +02:00
services.html.md Add Proxy Upstreams to Service Definition (#4639) 2018-10-10 16:55:34 +01:00
telemetry.html.md Correct rpc telemetry docs (#4602) 2018-08-28 16:38:22 -04:00
watches.html.md typo: missing space 2018-10-05 11:33:28 -05:00