Sign InTry Free

Deploy TiDB on General Kubernetes

This document describes how to deploy a TiDB cluster on general Kubernetes.

Prerequisites

Deploy the TiDB cluster

  1. Create Namespace:

    kubectl create namespace ${namespace}
    
  2. Deploy the TiDB cluster:

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

    If the server does not have an external network, you need to download the Docker image used by the TiDB cluster on a machine with Internet access and upload it to the server, and then use docker load to install the Docker image on the server.

    To deploy a TiDB cluster, you need the following Docker images (assuming the version of the TiDB cluster is v6.1.0):

    pingcap/pd:v6.1.0
    pingcap/tikv:v6.1.0
    pingcap/tidb:v6.1.0
    pingcap/tidb-binlog:v6.1.0
    pingcap/ticdc:v6.1.0
    pingcap/tiflash:v6.1.0
    pingcap/tidb-monitor-reloader:v1.0.1
    pingcap/tidb-monitor-initializer:v6.1.0
    grafana/grafana:6.0.1
    prom/prometheus:v2.18.1
    busybox:1.26.2
    

    Next, download all these images with the following command:

    docker pull pingcap/pd:v6.1.0
    docker pull pingcap/tikv:v6.1.0
    docker pull pingcap/tidb:v6.1.0
    docker pull pingcap/tidb-binlog:v6.1.0
    docker pull pingcap/ticdc:v6.1.0
    docker pull pingcap/tiflash:v6.1.0
    docker pull pingcap/tidb-monitor-reloader:v1.0.1
    docker pull pingcap/tidb-monitor-initializer:v6.1.0
    docker pull grafana/grafana:6.0.1
    docker pull prom/prometheus:v2.18.1
    docker pull busybox:1.26.2
    
    docker save -o pd-v6.1.0.tar pingcap/pd:v6.1.0
    docker save -o tikv-v6.1.0.tar pingcap/tikv:v6.1.0
    docker save -o tidb-v6.1.0.tar pingcap/tidb:v6.1.0
    docker save -o tidb-binlog-v6.1.0.tar pingcap/tidb-binlog:v6.1.0
    docker save -o ticdc-v6.1.0.tar pingcap/ticdc:v6.1.0
    docker save -o tiflash-v6.1.0.tar pingcap/tiflash:v6.1.0
    docker save -o tidb-monitor-reloader-v1.0.1.tar pingcap/tidb-monitor-reloader:v1.0.1
    docker save -o tidb-monitor-initializer-v6.1.0.tar pingcap/tidb-monitor-initializer:v6.1.0
    docker save -o grafana-6.0.1.tar grafana/grafana:6.0.1
    docker save -o prometheus-v2.18.1.tar prom/prometheus:v2.18.1
    docker save -o busybox-1.26.2.tar busybox:1.26.2
    

    Next, upload these Docker images to the server, and execute docker load to install these Docker images on the server:

    docker load -i pd-v6.1.0.tar
    docker load -i tikv-v6.1.0.tar
    docker load -i tidb-v6.1.0.tar
    docker load -i tidb-binlog-v6.1.0.tar
    docker load -i ticdc-v6.1.0.tar
    docker load -i tiflash-v6.1.0.tar
    docker load -i tidb-monitor-reloader-v1.0.1.tar
    docker load -i tidb-monitor-initializer-v6.1.0.tar
    docker load -i grafana-6.0.1.tar
    docker load -i prometheus-v2.18.1.tar
    docker load -i busybox-1.26.2.tar
    
  3. View the Pod status:

    kubectl get po -n ${namespace} -l app.kubernetes.io/instance=${cluster_name}
    

You can use TiDB Operator to deploy and manage multiple TiDB clusters in a single Kubernetes cluster by repeating the above procedure and replacing cluster_name with a different name.

Different clusters can be in the same or different namespace, which is based on your actual needs.

Initialize the TiDB cluster

If you want to initialize your cluster after deployment, refer to Initialize a TiDB Cluster on Kubernetes.

Download PDFRequest docs changes
Was this page helpful?
Open Source Ecosystem
TiDB
TiKV
TiSpark
Chaos Mesh
© 2022 PingCAP. All Rights Reserved.