Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
K
k3s
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Registry
Registry
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Jacklull
k3s
Commits
248881d4
Commit
248881d4
authored
Sep 10, 2015
by
Tim Hockin
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Update DNS docs to cover --resolv-conf
parent
92f21b3f
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
9 additions
and
9 deletions
+9
-9
README.md
cluster/addons/dns/README.md
+9
-9
No files found.
cluster/addons/dns/README.md
View file @
248881d4
...
@@ -43,17 +43,12 @@ For a regular service, this resolves to the port number and the CNAME:
...
@@ -43,17 +43,12 @@ For a regular service, this resolves to the port number and the CNAME:
`my-svc.my-namespace.svc.cluster.local`
.
`my-svc.my-namespace.svc.cluster.local`
.
For a headless service, this resolves to multiple answers, one for each pod
For a headless service, this resolves to multiple answers, one for each pod
that is backing the service, and contains the port number and a CNAME of the pod
that is backing the service, and contains the port number and a CNAME of the pod
with the format
`auto-generated-name.my-svc.my-namespace.svc.cluster.local`
of the form
`auto-generated-name.my-svc.my-namespace.svc.cluster.local`
.
SRV records always contain the 'svc' segment in them and are not supported for
old-style CNAMEs where the 'svc' segment was omitted.
### Backwards compatibility
### Backwards compatibility
Previous versions of kube-dns made names of the for
Previous versions of kube-dns made names of the for
`my-svc.my-namespace.cluster.local`
(the 'svc' level was added later). For
`my-svc.my-namespace.cluster.local`
(the 'svc' level was added later). This
compatibility, kube-dns supports both names for the time being. Users should
is no longer supported.
avoid creating a namespace named 'svc', to avoid conflicts. The old name
format is deprecated and will be removed in a future release.
## How do I find the DNS server?
## How do I find the DNS server?
The DNS server itself runs as a Kubernetes Service. This gives it a stable IP
The DNS server itself runs as a Kubernetes Service. This gives it a stable IP
...
@@ -178,6 +173,11 @@ paths to the node's own DNS settings. If the node is able to resolve DNS names
...
@@ -178,6 +173,11 @@ paths to the node's own DNS settings. If the node is able to resolve DNS names
specific to the larger environment, pods should be able to, also. See "Known
specific to the larger environment, pods should be able to, also. See "Known
issues" below for a caveat.
issues" below for a caveat.
If you don't want this, or if you want a different DNS config for pods, you can
use the kubelet's
`--resolv-conf`
flag. Setting it to "" means that pods will
not inherit DNS. Setting it to a valid file path means that kubelet will use
this file instead of
`/etc/resolv.conf`
for DNS inheritance.
## Known issues
## Known issues
Kubernetes installs do not configure the nodes' resolv.conf files to use the
Kubernetes installs do not configure the nodes' resolv.conf files to use the
cluster DNS by default, because that process is inherently distro-specific.
cluster DNS by default, because that process is inherently distro-specific.
...
@@ -190,7 +190,7 @@ consume 1 `nameserver` record and 3 `search` records. This means that if a
...
@@ -190,7 +190,7 @@ consume 1 `nameserver` record and 3 `search` records. This means that if a
local installation already uses 3
`nameserver`
s or uses more than 3
`search`
es,
local installation already uses 3
`nameserver`
s or uses more than 3
`search`
es,
some of those settings will be lost. As a partial workaround, the node can run
some of those settings will be lost. As a partial workaround, the node can run
`dnsmasq`
which will provide more
`nameserver`
entries, but not more
`search`
`dnsmasq`
which will provide more
`nameserver`
entries, but not more
`search`
entries.
entries.
You can also use kubelet's
`--resolv-conf`
flag.
## Making changes
## Making changes
Please observe the release process for making changes to the
`kube2sky`
Please observe the release process for making changes to the
`kube2sky`
...
...
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