kubernetes/cluster/addons/dns
Kubernetes Submit Queue debed6fa56 Merge pull request #38318 from MrHohn/dns-autoscale-doc
Automatic merge from submit-queue

Adds docs for dns-horizontal-autoscaler and kube-dns

Although we have separate docs on kubernetes.io, we should have a short description about the dns-horizontal-autoscaler addon in folder.

Also updates kube-dns README with example command to scale kube-dns Deployment. This is needed because Addon Manager v6 has stricter reconcile behavior.

@bowei @bprashanth @thockin
2016-12-07 14:22:21 -08:00
..
Makefile move kube-dns to the cluster/addons/ directory 2016-07-14 11:44:00 -07:00
README.md Adds docs for dns-horizontal-autoscaler and kube-dns 2016-12-07 11:36:08 -08:00
skydns-rc.yaml.base Fixes kubedns logging level 2016-12-02 16:24:22 -08:00
skydns-rc.yaml.in Fixes kubedns logging level 2016-12-02 16:24:22 -08:00
skydns-rc.yaml.sed Fixes kubedns logging level 2016-12-02 16:24:22 -08:00
skydns-svc.yaml.base remove cpu limits for dns pod. The current limits are not based on usage profiles 2016-09-21 19:14:52 -07:00
skydns-svc.yaml.in remove cpu limits for dns pod. The current limits are not based on usage profiles 2016-09-21 19:14:52 -07:00
skydns-svc.yaml.sed remove cpu limits for dns pod. The current limits are not based on usage profiles 2016-09-21 19:14:52 -07:00
transforms2salt.sed Migrates addons from using ReplicationControllers to Deployments 2016-11-09 09:17:05 -08:00
transforms2sed.sed Migrates addons from using ReplicationControllers to Deployments 2016-11-09 09:17:05 -08:00

kube-dns

kube-dns schedules DNS Pods and Service on the cluster, other pods in cluster can use the DNS Services IP to resolve DNS names.

More details on http://kubernetes.io/docs/admin/dns/.

Manually scale kube-dns Deployment

kube-dns creates only one DNS Pod by default. If dns-horizontal-autoscaler is not enabled, you may need to manually scale kube-dns Deployment.

Please use below kubectl scale command to scale:

kubectl --namespace=kube-system scale deployment kube-dns --replicas=<NUM_YOU_WANT>

Do not use kubectl edit to modify kube-dns Deployment object if it is controlled by Addon Manager. Otherwise the modifications will be clobbered, in addition the replicas count for kube-dns Deployment will be reset to 1. See Cluster add-ons README and #36411 for reference.

kube-dns Deployment and Service templates

This directory contains the base UNDERSCORE templates that can be used to generate the skydns-rc.yaml.in and skydns.rc.yaml.in needed in Salt format.

Due to a varied preference in templating language choices, the transform Makefile in this directory should be enhanced to generate all required formats from the base underscore templates.

NOTE WELL: Developers, when you add a parameter you should also update the various scripts that supply values for your new parameter. Here is one way you might find those scripts:

cd kubernetes
find [a-zA-Z0-9]* -type f -exec grep skydns-rc.yaml \{\} \; -print -exec echo \;

Base Template files

These are the authoritative base templates. Run 'make' to generate the Salt and Sed yaml templates from these.

skydns-rc.yaml.base skydns-svc.yaml.base

Generated Salt files

skydns-rc.yaml.in skydns-svc.yaml.in

Generated Sed files

skydns-rc.yaml.sed skydns-svc.yaml.sed

Analytics