Apache IoTDB部署升级指南：从AINode单机模式到Kubernetes集群

一、升级前准备

1. 环境检查

   • Kubernetes集群版本 ≥ 1.20（验证命令：kubectl version）
   • Helm 3.x 已安装（验证命令：helm version）
   • 单机IoTDB数据备份（执行：./sbin/stop-standalone.sh && cp -r data/ backup/）

2. 镜像准备

   # 从Docker Hub获取官方镜像
   docker pull apache/iotdb:1.2.0
   docker tag apache/iotdb:1.2.0 your-registry/iotdb:1.2.0
   docker push your-registry/iotdb:1.2.0
   

二、Kubernetes部署配置

1. 创建命名空间

   # iotdb-namespace.yaml
   apiVersion: v1
   kind: Namespace
   metadata:
     name: iotdb
   

   kubectl apply -f iotdb-namespace.yaml
   

2. StatefulSet核心配置

   # iotdb-statefulset.yaml
   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: iotdb
     namespace: iotdb
   spec:
     serviceName: "iotdb"
     replicas: 3  # 集群节点数
     selector:
       matchLabels:
         app: iotdb
     template:
       metadata:
         labels:
           app: iotdb
       spec:
         containers:
         - name: iotdb
           image: your-registry/iotdb:1.2.0
           ports:
           - containerPort: 6667  # 默认客户端端口
           - containerPort: 10730 # 内部通信端口
           volumeMounts:
           - name: data
             mountPath: /iotdb/data
     volumeClaimTemplates:
     - metadata:
         name: data
       spec:
         accessModes: [ "ReadWriteOnce" ]
         storageClassName: "standard"
         resources:
           requests:
             storage: 100Gi  # 按需调整
   

3. 服务暴露配置

   # iotdb-service.yaml
   apiVersion: v1
   kind: Service
   metadata:
     name: iotdb-service
     namespace: iotdb
   spec:
     selector:
       app: iotdb
     ports:
       - protocol: TCP
         port: 6667
         targetPort: 6667
     type: LoadBalancer  # 或NodePort根据环境选择
   

三、部署执行

# 应用配置
kubectl apply -f iotdb-namespace.yaml
kubectl apply -f iotdb-statefulset.yaml
kubectl apply -f iotdb-service.yaml

# 验证部署状态
kubectl get pods -n iotdb -w
# 预期输出示例：
# NAME      READY   STATUS    RESTARTS   AGE
# iotdb-0   1/1     Running   0          2m
# iotdb-1   1/1     Running   0          1m
# iotdb-2   1/1     Running   0          30s

四、数据迁移（单机→集群）

1. 导出单机数据

   # 进入单机IoTDB目录
   ./tools/export-csv.sh -h 127.0.0.1 -p 6667 -u root -pw root -o /path/to/export
   

2. 导入集群

   # 获取集群服务IP
   CLUSTER_IP=$(kubectl get svc iotdb-service -n iotdb -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
   
   # 执行导入
   ./tools/import-csv.sh -h $CLUSTER_IP -p 6667 -u root -pw root -f /path/to/export
   

五、验证与监控

1. 基础功能验证

   -- 通过CLI连接集群
   ./sbin/start-cli.sh -h $CLUSTER_IP -p 6667 -u root -pw root
   
   -- 执行测试查询
   SELECT * FROM root.ln.* LIMIT 10
   

2. 监控配置

   # Prometheus监控示例（部分）
   - job_name: 'iotdb'
     static_configs:
       - targets: ['iotdb-0.iotdb.iotdb.svc:9091', 
                  'iotdb-1.iotdb.iotdb.svc:9091',
                  'iotdb-2.iotdb.iotdb.svc:9091']
   

六、关键注意事项

1. 网络要求

   • 确保Kubernetes节点间网络延迟 < 50ms
   • 开放端口：6667（客户端）、10730（节点通信）、9091（监控）

2. 性能调优

   • JVM参数优化（StatefulSet环境变量）：

     env:
     - name: MAX_HEAP_SIZE
       value: "8G"  # 根据节点内存调整
     

3. 升级回滚方案

   # 回滚到单机模式（紧急恢复）
   kubectl delete -f iotdb-statefulset.yaml
   ./sbin/start-standalone.sh --restore /path/to/backup
   

升级收益：Kubernetes部署提供自动扩缩容、故障自愈和高可用能力，显著提升IoTDB的稳定性和吞吐量。通过StatefulSet保障时序数据持久化存储，结合LoadBalancer实现业务无感切换。