k8s.io/kubernetes@v1.31.0-alpha.0.0.20240520171757-56147500dadc/cluster/addons/dns/kube-dns/README.md (about)

     1  # kube-dns
     2  
     3  `kube-dns` schedules DNS Pods and Service on the cluster, other pods in cluster
     4  can use the DNS Service’s IP to resolve DNS names.
     5  
     6  * [Administrators guide](http://kubernetes.io/docs/admin/dns/)
     7  * [Code repository](http://www.github.com/kubernetes/dns)
     8  
     9  ## Manually scale kube-dns Deployment
    10  
    11  kube-dns creates only one DNS Pod by default. If
    12  [dns-horizontal-autoscaler](../../dns-horizontal-autoscaler/)
    13  is not enabled, you may need to manually scale kube-dns Deployment.
    14  
    15  Please use below `kubectl scale` command to scale:
    16  ```
    17  kubectl --namespace=kube-system scale deployment kube-dns --replicas=<NUM_YOU_WANT>
    18  ```
    19  
    20  Do not use `kubectl edit` to modify kube-dns Deployment object if it is
    21  controlled by [Addon Manager](../../addon-manager/). Otherwise the modifications
    22  will be clobbered, in addition the replicas count for kube-dns Deployment will
    23  be reset to 1. See [Cluster add-ons README](../../README.md) and
    24  [#36411](https://github.com/kubernetes/kubernetes/issues/36411) for reference.
    25  
    26  ## kube-dns addon templates
    27  
    28  This directory contains the base UNDERSCORE templates that can be used to
    29  generate the kube-dns.yaml.in needed in Salt format.
    30  
    31  Due to a varied preference in templating language choices, the transform
    32  Makefile in this directory should be enhanced to generate all required formats
    33  from the base underscore templates.
    34  
    35  **N.B.**: When you add a parameter you should also update the various scripts
    36  that supply values for your new parameter.  Here is one way you might find those
    37  scripts:
    38  
    39  ```
    40  cd kubernetes && git grep 'kube-dns.yaml'
    41  ```
    42  
    43  ### Base Template files
    44  
    45  These are the authoritative base templates.
    46  Run 'make' to generate the Salt and Sed yaml templates from these.
    47  
    48  ```
    49  kube-dns.yaml.base
    50  ```
    51  
    52  ### Generated Salt files
    53  
    54  ```
    55  kube-dns.yaml.in
    56  ```
    57  
    58  ### Generated Sed files
    59  
    60  ```
    61  kube-dns.yaml.sed
    62  ```