From a7cf8c3d0fbac398db00c80697bb0f4f2139be11 Mon Sep 17 00:00:00 2001
From: Shuduo Sang <sangshuduo@gmail.com>
Date: Thu, 11 Aug 2022 20:54:03 +0800
Subject: [PATCH] docs: refine k8s docs for3.0 (#16011)

* docs: update k8s doc for 3.0

* docs: update 03-k8s.md

* docs: refine 03-k8s.md
---
 docs/zh/10-deployment/03-k8s.md | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)

diff --git a/docs/zh/10-deployment/03-k8s.md b/docs/zh/10-deployment/03-k8s.md
index ab1bff4449..6bab4d2cec 100644
--- a/docs/zh/10-deployment/03-k8s.md
+++ b/docs/zh/10-deployment/03-k8s.md
@@ -3,11 +3,20 @@ sidebar_label: Kubernetes
 title: 在 Kubernetes 上部署 TDengine 集群
 ---
 
-以下配置文件可以从 [GitHub 仓库](https://github.com/taosdata/TDengine-Operator/tree/3.0/src/tdengine) 下载。
+作为面向云原生架构设计的时序数据库，可以方便的通过 Kubernetes 部署并管理 TDengine 集群。这里介绍如何使用 YAML 文件一步一步从头创建一个TDengine集群，并重点介绍 Kubernetes 环境下 TDengine 的常用操作。
+
+## 前置条件
+
+要使用 Kubernetes 部署管理 TDengine 集群，需要做好如下准备工作。
+
+* 本文和下一章使用 minikube、kubectl 和 helm 等工具进行安装部署，请提前安装好相应软件
+* Kubernetes 已经安装部署并能正常访问使用或更新必要的容器仓库或其他服务
+
+以下配置文件也可以从 [GitHub 仓库](https://github.com/taosdata/TDengine-Operator/tree/3.0/src/tdengine) 下载。
 
 ## 配置 Service 服务
 
-创建一个 Service 配置文件：`taosd-service.yaml`，服务名称 `metadata.name` (此处为 "taosd") 将在下一步中使用到。添加 TDengine 所用到的所有端口：
+创建一个 Service 配置文件：`taosd-service.yaml`，服务名称 `metadata.name` (此处为 "taosd") 将在下一步中使用到。添加 TDengine 所用到的端口：
 
 ```yaml
 ---
@@ -31,7 +40,8 @@ spec:
 
 ## 有状态服务 StatefulSet
 
-根据 Kubernetes 对各类部署的说明，我们将使用 StatefulSet 作为 TDengine 的服务类型，创建文件 `tdengine.yaml`：
+根据 Kubernetes 对各类部署的说明，我们将使用 StatefulSet 作为 TDengine 的服务类型。
+创建文件 `tdengine.yaml`，其中 replicas 定义集群节点的数量为 3。节点时区为中国（Asia/Shanghai），每个节点分配 10G 标准（standard）存储。你也可以根据实际情况进行相应修改。
 
 ```yaml
 ---
@@ -43,7 +53,7 @@ metadata:
     app: "tdengine"
 spec:
   serviceName: "taosd"
-  replicas: 2
+  replicas: 3
   updateStrategy:
     type: RollingUpdate
   selector:
@@ -58,10 +68,7 @@ spec:
       containers:
         - name: "tdengine"
           image: "tdengine/tdengine:3.0.0.0"
-          imagePullPolicy: "Always"
-          envFrom:
-            - configMapRef:
-                name: taoscfg
+          imagePullPolicy: "IfNotPresent"
           ports:
             - name: tcp6030
               protocol: "TCP"
@@ -130,10 +137,9 @@ spec:
 ```bash
 kubectl apply -f taosd-service.yaml
 kubectl apply -f tdengine.yaml
-
 ```
 
-上面的配置将生成一个三节点的 TDengine 集群，dnode 是自动配置的，可以使用 show dnodes 命令查看当前集群的节点：
+上面的配置将生成一个三节点的 TDengine 集群，dnode 为自动配置，可以使用 show dnodes 命令查看当前集群的节点：
 
 ```bash
 kubectl exec -i -t tdengine-0 -- taos -s "show dnodes"
-- 
GitLab