Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Sign in / Register
Toggle navigation
C
Coredns
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Locked Files
Issues
0
Issues
0
List
Boards
Labels
Service Desk
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Security & Compliance
Security & Compliance
Dependency List
License Compliance
Packages
Packages
List
Container Registry
Analytics
Analytics
CI / CD
Code Review
Insights
Issues
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Railgun
Coredns
Commits
d42f5446
Commit
d42f5446
authored
Aug 14, 2019
by
Cricket Liu
Committed by
Chris O'Haver
Aug 14, 2019
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Update README.md (#3131)
Just minor textual cleanup.
parent
70b9cdb5
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
8 additions
and
8 deletions
+8
-8
plugin/k8s_external/README.md
plugin/k8s_external/README.md
+8
-8
No files found.
plugin/k8s_external/README.md
View file @
d42f5446
...
...
@@ -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.
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.
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
example.org. 5 IN SOA ns1.dns.example.org. hostmaster.example.org. (
...
...
@@ -29,11 +29,11 @@ ns1.dns.example.org. 5 IN A ....
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
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.
## Syntax
...
...
@@ -44,7 +44,7 @@ k8s_external [ZONE...]
*
**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 return
ed
records you can use
this extended syntax.
~~~
...
...
@@ -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).
# 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.
}
~~~
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
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment