在 Kubernetes 上部署 TiDB Operator

本文介绍如何在 Kubernetes 上部署 TiDB Operator。

准备环境

部署 TiDB Operator 前，请确保你的环境满足以下软件要求：

• Kubernetes >= v1.30
• kubectl >= v1.30
• Helm >= v3.8

部署 Kubernetes 集群

TiDB Operator 运行在 Kubernetes 集群中。你可以选择以下任一方式搭建 Kubernetes 集群：

• 自托管集群：根据 Kubernetes 官方文档中任意一种方法搭建自托管的 Kubernetes 集群。
• 云服务提供商：使用 Kubernetes 认证的云服务提供商提供的 Kubernetes 集群服务。

无论选择哪种方式，请务必确保你的 Kubernetes 版本为 v1.30 或更高。如果需要快速搭建一个用于测试的简单集群，可以参考快速上手教程。

部署 TiDB Operator CRD

执行以下命令，安装 TiDB Operator 所需的 Custom Resource Definition (CRD)：

kubectl apply -f https://github.com/pingcap/tidb-operator/releases/download/v2.0.0-beta.0/tidb-operator.crds.yaml --server-side

部署 TiDB Operator

你可以通过以下两种方式部署 TiDB Operator：

• 使用 kubectl apply 快速部署
• 使用 Helm 部署

方式一：使用 kubectl apply 快速部署

TiDB Operator 安装所需的所有资源（包括 RBAC 和 Deployment 等，CRD 除外）都已打包在 tidb-operator.yaml 文件中。你可以使用以下命令一键部署，无需额外指定参数：

kubectl apply -f https://github.com/pingcap/tidb-operator/releases/download/v2.0.0-beta.0/tidb-operator.yaml --server-side

TiDB Operator 将被部署到 tidb-admin namespace 下。你可以运行以下命令验证安装是否成功：

kubectl get pods -n tidb-admin

预期输出如下：

NAME                             READY   STATUS    RESTARTS   AGE
tidb-operator-6c98b57cc8-ldbnr   1/1     Running   0          2m

方式二：使用 Helm 部署

使用 Helm 部署除 CRD 外的所有资源：

helm install tidb-operator oci://ghcr.io/pingcap/charts/tidb-operator --version v2.0.0-beta.0 --namespace tidb-admin --create-namespace

TiDB Operator 将被部署到 tidb-admin namespace 下。你可以运行以下命令验证安装是否成功：

kubectl get pods -n tidb-admin

预期输出如下：

NAME                             READY   STATUS    RESTARTS   AGE
tidb-operator-6c98b57cc8-ldbnr   1/1     Running   0          2m

自定义安装

如需自定义部署参数，请先导出默认的 values.yaml 文件：

helm show values oci://ghcr.io/pingcap/charts/tidb-operator --version v2.0.0-beta.0 > values.yaml

根据需要修改 values.yaml，然后执行以下命令安装：

helm install tidb-operator oci://ghcr.io/pingcap/charts/tidb-operator --version v2.0.0-beta.0 -f values.yaml