Doc Menu

Restart a TiDB Cluster in Kubernetes

If you find that the memory leak occurs in a Pod during use, you need to restart the cluster. This document describes how to perform a graceful rolling restart to all the Pods in a component of the TiDB cluster, or gracefully log off a Pod in the TiDB cluster and then restart the Pod using the graceful restart command.


It is not recommended to manually remove a Pod in the TiDB cluster without graceful restart in a production environment, because this might lead to some request failures of accessing the TiDB cluster though the StatefulSet controller pulls the Pod up again.

Performing a graceful rolling restart to all Pods in a component

  1. Refer to Deploy TiDB on general Kubernetes and modify the ${cluster_name}/tidb-cluster.yaml file.

    Add in the annotation of the spec of the TiDB component you want to gracefully rolling restart, and set its value to be the current time.

    In the following example, annotations of the pd, tikv, and tidb components are set, which means that all the Pods in these three components will be gracefully rolling restarted. You can set the annotation for a specific component according to your needs.

    kind: TidbCluster
      name: basic
      version: v4.0.6
      timezone: UTC
      pvReclaimPolicy: Delete
        baseImage: pingcap/pd
        replicas: 3
          storage: "1Gi"
        config: {}
        baseImage: pingcap/tikv
        replicas: 3
          storage: "1Gi"
        config: {}
        baseImage: pingcap/tidb
        replicas: 2
          type: ClusterIP
        config: {}
  2. Apply the update:

    kubectl apply -f ${cluster_name} -n ${namespace}

Gracefully restart a single Pod of the TiDB component

This section describes how to gracefully restart a single Pod of the component in a TiDB cluster.

Enable the configurations

To activate the graceful logoff feature, you need to enable some related configurations in TiDB Operator. These configurations are disabled by default. Take the following steps to manually turn them on.

  1. Edit the values.yaml file.

    Enable the Operator Webhook feature:

      create: true

    For more information about Operator Webhook, see Enable Admission Controller in TiDB Operator.

  2. Install or update TiDB Operator.

    To install or update TiDB Operator, see Deploy TiDB Operator in Kubernetes.

Use annotate to mark the target Pod

You can use kubectl annotate to mark the target Pod component of the TiDB cluster. After marking, the TiDB Operator automatically performs graceful logoff of the Pod and restarts the target Pod. To mark the target Pod, run the following command:

kubectl annotate ${pod_name} -n ${namespace}