Commit d42f5446 authored by Cricket Liu's avatar Cricket Liu Committed by Chris O'Haver

Update README.md (#3131)

Just minor textual cleanup.
parent 70b9cdb5
...@@ -10,10 +10,10 @@ This plugin allows an additional zone to resolve the external IP address(es) of ...@@ -10,10 +10,10 @@ This plugin allows an additional zone to resolve the external IP address(es) of
service. This plugin is only useful if the *kubernetes* plugin is also loaded. service. This plugin is only useful if the *kubernetes* plugin is also loaded.
The plugin uses an external zone to resolve in-cluster IP addresses. It only handles queries for A, The plugin uses an external zone to resolve in-cluster IP addresses. It only handles queries for A,
AAAA and SRV records, all others result in NODATA responses. To make it a proper DNS zone it handles AAAA and SRV records; all others result in NODATA responses. To make it a proper DNS zone, it handles
SOA and NS queries for the apex of the zone. SOA and NS queries for the apex of the zone.
By default the apex of the zone will look like (assuming the zone used is `example.org`): By default the apex of the zone will look like the following (assuming the zone used is `example.org`):
~~~ dns ~~~ dns
example.org. 5 IN SOA ns1.dns.example.org. hostmaster.example.org. ( example.org. 5 IN SOA ns1.dns.example.org. hostmaster.example.org. (
...@@ -29,11 +29,11 @@ ns1.dns.example.org. 5 IN A .... ...@@ -29,11 +29,11 @@ ns1.dns.example.org. 5 IN A ....
ns1.dns.example.org. 5 IN AAAA .... ns1.dns.example.org. 5 IN AAAA ....
~~~ ~~~
Note we use the `dns` subdomain to place the records the DNS needs (see the `apex` directive). Also Note that we use the `dns` subdomain for the records DNS needs (see the `apex` directive). Also
note the SOA's serial number is static. The IP addresses of the nameserver records are those of the note the SOA's serial number is static. The IP addresses of the nameserver records are those of the
CoreDNS service. CoreDNS service.
The *k8s_external* plugin handles the subdomain `dns` and the apex of the zone by itself, all other The *k8s_external* plugin handles the subdomain `dns` and the apex of the zone itself; all other
queries are resolved to addresses in the cluster. queries are resolved to addresses in the cluster.
## Syntax ## Syntax
...@@ -44,7 +44,7 @@ k8s_external [ZONE...] ...@@ -44,7 +44,7 @@ k8s_external [ZONE...]
* **ZONES** zones *k8s_external* should be authoritative for. * **ZONES** zones *k8s_external* should be authoritative for.
If you want to change the apex domain or use a different TTL for the return records you can use If you want to change the apex domain or use a different TTL for the returned records you can use
this extended syntax. this extended syntax.
~~~ ~~~
...@@ -54,12 +54,12 @@ k8s_external [ZONE...] { ...@@ -54,12 +54,12 @@ k8s_external [ZONE...] {
} }
~~~ ~~~
* **APEX** is the name (DNS label) to use the apex records, defaults to `dns`. * **APEX** is the name (DNS label) to use for the apex records; it defaults to `dns`.
* `ttl` allows you to set a custom **TTL** for responses. The default is 5 (seconds). * `ttl` allows you to set a custom **TTL** for responses. The default is 5 (seconds).
# Examples # Examples
Enable names under `example.org` to be resolved to in cluster DNS addresses. Enable names under `example.org` to be resolved to in-cluster DNS addresses.
~~~ ~~~
. { . {
...@@ -68,7 +68,7 @@ Enable names under `example.org` to be resolved to in cluster DNS addresses. ...@@ -68,7 +68,7 @@ Enable names under `example.org` to be resolved to in cluster DNS addresses.
} }
~~~ ~~~
With the Corefile above, the following Service will get an `A` record for `test.default.example.org` with IP address `192.168.200.123`. With the Corefile above, the following Service will get an `A` record for `test.default.example.org` with the IP address `192.168.200.123`.
~~~ ~~~
apiVersion: v1 apiVersion: v1
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment