Doc Menu

Upgrade TiDB Operator and Kubernetes

This document describes how to upgrade TiDB Operator and Kubernetes.

Upgrade TiDB Operator

  1. Update CRD (Custom Resource Definition):

    kubectl apply -f${version}/manifests/crd.yaml && \
    kubectl get crd


    The ${version} in this document represents the version of TiDB Operator, such as v1.1.6. You can check the currently supported version using the helm search -l tidb-operator command.

  2. Get the values.yaml file of the tidb-operator chart that you want to install:

    mkdir -p ${HOME}/tidb-operator/${version} && \
    helm inspect values pingcap/tidb-operator --version=${version} > ${HOME}/tidb-operator/${version}/values-tidb-operator.yaml
  3. Modify the operatorImage image in the ${HOME}/tidb-operator/${version}/values-tidb-operator.yaml file. Merge the customized configuration in the old values.yaml file with the ${HOME}/tidb-operator/${version}/values-tidb-operator.yaml file, and execute helm upgrade:

    helm upgrade tidb-operator pingcap/tidb-operator --version=${version} -f ${HOME}/tidb-operator/${version}/values-tidb-operator.yaml


    After TiDB Operator is upgraded, the discovery deployment in all TiDB clusters will automatically upgrade to the specified version of TiDB Operator.

Upgrade TiDB Operator from v1.0 to v1.1 or later releases

Since TiDB Operator v1.1.0, PingCAP no longer updates or maintains the tidb-cluster chart. The components and features that have been managed using the tidb-cluster chart will be managed by CR (Custom Resource) or dedicated charts in v1.1. For more details, refer to TiDB Operator v1.1 Notes.


By default, TiDB (starting from v4.0.2) periodically shares usage details with PingCAP to help understand how to improve the product. For details about what is shared and how to disable the sharing, see Telemetry.