236 lines
6.9 KiB
Markdown
236 lines
6.9 KiB
Markdown
---
|
||
title: Autoscale the DNS Service in a Cluster
|
||
content_template: templates/task
|
||
---
|
||
|
||
{{% capture overview %}}
|
||
This page shows how to enable and configure autoscaling of the DNS service in
|
||
your Kubernetes cluster.
|
||
{{% /capture %}}
|
||
|
||
{{% capture prerequisites %}}
|
||
|
||
* {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
|
||
|
||
* This guide assumes your nodes use the AMD64 or Intel 64 CPU architecture.
|
||
|
||
* Make sure [Kubernetes DNS](/docs/concepts/services-networking/dns-pod-service/) is enabled.
|
||
|
||
{{% /capture %}}
|
||
|
||
{{% capture steps %}}
|
||
|
||
## Determine whether DNS horizontal autoscaling is already enabled {#determining-whether-dns-horizontal-autoscaling-is-already-enabled}
|
||
|
||
List the {{< glossary_tooltip text="Deployments" term_id="deployment" >}}
|
||
in your cluster in the kube-system {{< glossary_tooltip text="namespace" term_id="namespace" >}}:
|
||
|
||
```shell
|
||
kubectl get deployment --namespace=kube-system
|
||
```
|
||
|
||
The output is similar to this:
|
||
|
||
NAME READY UP-TO-DATE AVAILABLE AGE
|
||
...
|
||
dns-autoscaler 1/1 1 1 ...
|
||
...
|
||
|
||
If you see "dns-autoscaler" in the output, DNS horizontal autoscaling is
|
||
already enabled, and you can skip to
|
||
[Tuning autoscaling parameters](#tuning-autoscaling-parameters).
|
||
|
||
## Get the name of your DNS Deployment {#find-scaling-target}
|
||
|
||
List the DNS deployments in your cluster in the kube-system namespace:
|
||
|
||
```shell
|
||
kubectl get deployment -l k8s-app=kube-dns --namespace=kube-system
|
||
```
|
||
|
||
The output is similar to this:
|
||
|
||
NAME READY UP-TO-DATE AVAILABLE AGE
|
||
...
|
||
coredns 2/2 2 2 ...
|
||
...
|
||
|
||
If you don't see a Deployment for DNS services, you can also look for it by name:
|
||
|
||
```shell
|
||
kubectl get deployment --namespace=kube-system
|
||
```
|
||
|
||
and look for a deployment named `coredns` or `kube-dns`.
|
||
|
||
|
||
Your scale target is
|
||
|
||
Deployment/<your-deployment-name>
|
||
|
||
where `<your-deployment-name>` is the name of your DNS Deployment. For example, if
|
||
the name of your Deployment for DNS is coredns, your scale target is Deployment/coredns.
|
||
|
||
{{< note >}}
|
||
CoreDNS is the default DNS service for Kubernetes. CoreDNS sets the label
|
||
`k8s-app=kube-dns` so that it can work in clusters that originally used
|
||
kube-dns.
|
||
{{< /note >}}
|
||
|
||
## Enable DNS horizontal autoscaling {#enablng-dns-horizontal-autoscaling}
|
||
|
||
In this section, you create a new Deployment. The Pods in the Deployment run a
|
||
container based on the `cluster-proportional-autoscaler-amd64` image.
|
||
|
||
Create a file named `dns-horizontal-autoscaler.yaml` with this content:
|
||
|
||
{{< codenew file="admin/dns/dns-horizontal-autoscaler.yaml" >}}
|
||
|
||
In the file, replace `<SCALE_TARGET>` with your scale target.
|
||
|
||
Go to the directory that contains your configuration file, and enter this
|
||
command to create the Deployment:
|
||
|
||
```shell
|
||
kubectl apply -f dns-horizontal-autoscaler.yaml
|
||
```
|
||
|
||
The output of a successful command is:
|
||
|
||
deployment.apps/dns-autoscaler created
|
||
|
||
DNS horizontal autoscaling is now enabled.
|
||
|
||
## Tune DNS autoscaling parameters {#tuning-autoscaling-parameters}
|
||
|
||
Verify that the dns-autoscaler {{< glossary_tooltip text="ConfigMap" term_id="configmap" >}} exists:
|
||
|
||
```shell
|
||
kubectl get configmap --namespace=kube-system
|
||
```
|
||
|
||
The output is similar to this:
|
||
|
||
NAME DATA AGE
|
||
...
|
||
dns-autoscaler 1 ...
|
||
...
|
||
|
||
Modify the data in the ConfigMap:
|
||
|
||
```shell
|
||
kubectl edit configmap dns-autoscaler --namespace=kube-system
|
||
```
|
||
|
||
Look for this line:
|
||
|
||
```yaml
|
||
linear: '{"coresPerReplica":256,"min":1,"nodesPerReplica":16}'
|
||
```
|
||
|
||
Modify the fields according to your needs. The "min" field indicates the
|
||
minimal number of DNS backends. The actual number of backends is
|
||
calculated using this equation:
|
||
|
||
replicas = max( ceil( cores × 1/coresPerReplica ) , ceil( nodes × 1/nodesPerReplica ) )
|
||
|
||
Note that the values of both `coresPerReplica` and `nodesPerReplica` are
|
||
floats.
|
||
|
||
The idea is that when a cluster is using nodes that have many cores,
|
||
`coresPerReplica` dominates. When a cluster is using nodes that have fewer
|
||
cores, `nodesPerReplica` dominates.
|
||
|
||
There are other supported scaling patterns. For details, see
|
||
[cluster-proportional-autoscaler](https://github.com/kubernetes-incubator/cluster-proportional-autoscaler).
|
||
|
||
## Disable DNS horizontal autoscaling
|
||
|
||
There are a few options for tuning DNS horizontal autoscaling. Which option to
|
||
use depends on different conditions.
|
||
|
||
### Option 1: Scale down the dns-autoscaler deployment to 0 replicas
|
||
|
||
This option works for all situations. Enter this command:
|
||
|
||
```shell
|
||
kubectl scale deployment --replicas=0 dns-autoscaler --namespace=kube-system
|
||
```
|
||
|
||
The output is:
|
||
|
||
deployment.extensions/dns-autoscaler scaled
|
||
|
||
Verify that the replica count is zero:
|
||
|
||
```shell
|
||
kubectl get rs --namespace=kube-system
|
||
```
|
||
|
||
The output displays 0 in the DESIRED and CURRENT columns:
|
||
|
||
NAME DESIRED CURRENT READY AGE
|
||
...
|
||
dns-autoscaler-6b59789fc8 0 0 0 ...
|
||
...
|
||
|
||
### Option 2: Delete the dns-autoscaler deployment
|
||
|
||
This option works if dns-autoscaler is under your own control, which means
|
||
no one will re-create it:
|
||
|
||
```shell
|
||
kubectl delete deployment dns-autoscaler --namespace=kube-system
|
||
```
|
||
|
||
The output is:
|
||
|
||
deployment.apps "dns-autoscaler" deleted
|
||
|
||
### Option 3: Delete the dns-autoscaler manifest file from the master node
|
||
|
||
This option works if dns-autoscaler is under control of the (deprecated)
|
||
[Addon Manager](https://git.k8s.io/kubernetes/cluster/addons/README.md),
|
||
and you have write access to the master node.
|
||
|
||
Sign in to the master node and delete the corresponding manifest file.
|
||
The common path for this dns-autoscaler is:
|
||
|
||
/etc/kubernetes/addons/dns-horizontal-autoscaler/dns-horizontal-autoscaler.yaml
|
||
|
||
After the manifest file is deleted, the Addon Manager will delete the
|
||
dns-autoscaler Deployment.
|
||
|
||
{{% /capture %}}
|
||
|
||
{{% capture discussion %}}
|
||
|
||
## Understanding how DNS horizontal autoscaling works
|
||
|
||
* The cluster-proportional-autoscaler application is deployed separately from
|
||
the DNS service.
|
||
|
||
* An autoscaler Pod runs a client that polls the Kubernetes API server for the
|
||
number of nodes and cores in the cluster.
|
||
|
||
* A desired replica count is calculated and applied to the DNS backends based on
|
||
the current schedulable nodes and cores and the given scaling parameters.
|
||
|
||
* The scaling parameters and data points are provided via a ConfigMap to the
|
||
autoscaler, and it refreshes its parameters table every poll interval to be up
|
||
to date with the latest desired scaling parameters.
|
||
|
||
* Changes to the scaling parameters are allowed without rebuilding or restarting
|
||
the autoscaler Pod.
|
||
|
||
* The autoscaler provides a controller interface to support two control
|
||
patterns: *linear* and *ladder*.
|
||
|
||
{{% /capture %}}
|
||
|
||
{{% capture whatsnext %}}
|
||
* Read about [Guaranteed Scheduling For Critical Add-On Pods](/docs/tasks/administer-cluster/guaranteed-scheduling-critical-addon-pods/).
|
||
* Learn more about the
|
||
[implementation of cluster-proportional-autoscaler](https://github.com/kubernetes-incubator/cluster-proportional-autoscaler).
|
||
{{% /capture %}}
|