时序数据库 Apache IoTDB 实战：基于 Kubernetes 的部署运维全指南

技术文档

时序 数据库 Apache IoTDB 实战：基于 Kubernetes 的部署运维全指南

在这里插入图片描述

前言

随着物联网设备爆发式增长，海量时序数据的高效存储与分析成为关键挑战，Apache IoTDB 作为专为物联网设计的时序数据库，以高吞吐写入、低存储成本和灵活查询能力著称，而 Kubernetes 则为其提供了弹性部署与运维的标准化平台，本文聚焦 IoTDB 在 K8s 环境的核心部署实践，涵盖环境准备、集群搭建、故障排查与弹性扩容，并辅以基础操作示例，为物联网时序数据管理提供高效落地方案。

Apache IoTDB 介绍

在这里插入图片描述

Apache IoTDB 专为物联网场景设计的开源时序数据库，高效存储、管理和分析海量物联网设备产生的时序数据，由 Apache 软件基金会孵化并托管，具有高写入性能、低存储成本、灵活的查询能力和良好的可扩展性，广泛应用于工业物联网、智能家居、智慧城市等地方

✅极致的时序数据处理效率：针对物联网高频产生的时序数据深度优化，支持每秒数百万级写入，同时通过列式存储和时间分区技术实现 5-10 倍于传统数据库的压缩率，大幅降低存储成本，兼顾高吞吐与低存储开销

✅灵活且强大的时序查询能力：提供类 SQL 的查询语言，支持数据筛选、聚合、时间窗口分析、降采样等时序特有的操作，同时支持多设备数据对齐，满足实时监控与历史数据分析的双重需求

✅边缘与云端协同的高扩展性：轻量级设计可部署于边缘设备，实现本地化数据存储；同时支持分布式集群部署，通过水平扩展提升存储与计算能力，结合数据分片和副本机制，保障数据可靠性与负载均衡，适配从边缘到云端的全场景需求

前提准备

✅K8s 集群：版本≥1.24，至少 3 节点（4 核 8G 起），网络互通

✅存储：配置支持动态 PV 的 StorageClass（推荐 SSD）

✅网络：部署高性能 CNI 插件（如 Calico），规划外部访问方式

✅镜像：准备 IoTDB 镜像（版本≥1.3.3.2）

✅权限：创建专用命名空间（如 iotdb）及必要 RBAC 权限

IoTDB Kubernetes 部署

1、创建命名空间

kubectl create ns iotdb-ns

2、查看命名空间

kubectl get ns

3、创建 PV 配置文件

#可新建个文件夹放yaml文件#创建 pv.yaml 文件语句touch pv.yaml

4、pv.yaml 示例

# pv.yamlapiVersion: v1kind: PersistentVolumemetadata: name: iotdb-pv-01spec: capacity: storage: 10Gi # 存储容量 accessModes: # 访问模式 - ReadWriteOnce persistentVolumeReclaimPolicy: Retain # 回收策略 # 存储类名称，如果使用本地静态存储storageClassName 不用配置，如果使用动态存储必需设置此项 storageClassName: local-storage # 根据你的存储类型添加相应的配置 hostPath: # 如果是使用本地路径 path: /data/k8s-data/iotdb-pv-01 type: DirectoryOrCreate # 这行不配置就要手动创建文件夹

5、应用 PV 配置

kubectl apply -f pv01.yamlkubectl apply -f pv-02.yaml...

6、查看 PV

kubectl get pv

在这里插入图片描述

7、手动创建文件夹

mkdir -p /data/k8s-data/iotdb-pv-01mkdir -p /data/k8s-data/iotdb-pv-02...

8、克隆 IoTDB Kubernetes 部署代码

unset HTTPS_PROXY

9、修改 YAML 文件

nameOverride: \"iotdb\" fullnameOverride: \"iotdb\" #软件安装后的名称image: repository: nexus.infra.timecho.com:8143/timecho/iotdb-enterprise pullPolicy: IfNotPresent tag: 1.3.3.2-standalone #软件所用的仓库和版本storage:# 存储类名称，如果使用本地静态存储storageClassName 不用配置，如果使用动态存储必需设置此项 className: local-storagedatanode: name: datanode nodeCount: 3 #datanode的节点数量 enableRestService: true storageCapacity: 10Gi #datanode的可用空间大小 resources: requests: memory: 2Gi #datanode的内存初始化大小 cpu: 1000m #datanode的CPU初始化大小 limits: memory: 4Gi #datanode的最大内存大小 cpu: 1000m #datanode的最大CPU大小confignode: name: confignode nodeCount: 3 #confignode的节点数量 storageCapacity: 10Gi #confignode的可用空间大小 resources: requests: memory: 512Mi #confignode的内存初始化大小 cpu: 1000m #confignode的CPU初始化大小 limits: memory: 1024Mi #confignode的最大内存大小 cpu: 2000m #confignode的最大CPU大小 configNodeConsensusProtocolClass: org.apache.iotdb.consensus.ratis.RatisConsensus schemaReplicationFactor: 3 schemaRegionConsensusProtocolClass: org.apache.iotdb.consensus.ratis.RatisConsensus dataReplicationFactor: 2 dataRegionConsensusProtocolClass: org.apache.iotdb.consensus.iot.IoTConsensus

10、从私有仓库拉取镜像，创建secret 使k8s可访问iotdb-helm的私有仓库

# 注意 单引号kubectl create secret docker-registry timecho-nexus \\ --docker-server=\'nexus.infra.timecho.com:8143\' \\ --docker-username=\'xxxxxx\' \\ --docker-password=\'xxxxxx\' \\ --docker-email=\'xxxxxx\' \\ -n iotdb-ns # 查看secretkubectl get secret timecho-nexus -n iotdb-ns# 查看并输出为yamlkubectl get secret timecho-nexus --output=yaml -n iotdb-ns# 查看并解密kubectl get secret timecho-nexus --output=\"jsonpath={.data.\\.dockerconfigjson}\" -n iotdb-ns | base64 --decode

11、安装 IoTDB

# 进入文件夹cd iotdb-cluster-k8s/helm# 安装iotdbhelm install iotdb ./ -n iotdb-ns

12、查看 Helm 安装列表

# helm listhelm list -n iotdb-ns

13、查看 Pods

# 查看 iotdb的podskubectl get pods -n iotdb-ns -o wide

14、发现故障的排除方式

# 查看k8s的创建logkubectl get events -n iotdb-ns watch kubectl get events -n iotdb-ns# 获取详细信息kubectl describe pod confignode-0 -n iotdb-nskubectl describe pod datanode-0 -n iotdb-ns# 查看confignode日志kubectl logs -n iotdb-ns confignode-0 -f

15、激活 IoTDB，进入confignode的容器中激活

kubectl exec -it -n iotdb-ns confignode-0 -- /bin/bashcd /iotdb/sbin/bin/bash start-activate.sh# 拿到机器码后进行激活# 退出容器

16、验证 IoTDB（查看iotdb-ns命名空间内的IP、状态等信息，确定全部运行正常）

kubectl get pods -n iotdb-ns -o wide# 结果示例：# NAME  READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES# confignode-0 1/1 Running 0 75m 10.20.187.14 a87   # confignode-1 1/1 Running 0 75m 10.20.191.75 a88   # confignode-2 1/1 Running 0 75m 10.20.187.16 a87   # datanode-0 1/1 Running 10 (5m54s ago) 75m 10.20.191.74 a88   # datanode-1 1/1 Running 10 (5m42s ago) 75m 10.20.187.15 a87   # datanode-2 1/1 Running 10 (5m55s ago) 75m 10.20.191.76 a88

17、查看命名空间内的端口映射情况

kubectl get svc -n iotdb-ns# 结果示例：# NAME TYPE  CLUSTER-IP EXTERNAL-IP PORT(S) AGE# confignode-svc NodePort 10.10.226.151  80:31026/TCP 7d8h# datanode-svc NodePort 10.10.194.225  6667:31563/TCP 7d8h# jdbc-balancer LoadBalancer 10.10.191.209  6667:31895/TCP 7d8h

18、在任意服务器启动 CLI 脚本验证 IoTDB 集群状态（端口即jdbc-balancer的端口，服务器为k8s任意节点的IP）

start-cli.sh -h 172.20.31.86 -p 31895start-cli.sh -h 172.20.31.87 -p 31895start-cli.sh -h 172.20.31.88 -p 31895

在这里插入图片描述

19、扩容，新增pv

在这里插入图片描述

20、扩容confignode：修改iotdb-cluster-k8s/helm的values.yaml文件，将confignode的3改成4

helm upgrade iotdb . -n iotdb-ns

在这里插入图片描述

21、扩容datanode（修改iotdb-cluster-k8s/helm的values.yaml文件，将datanode的3改成4）

helm upgrade iotdb . -n iotdb-ns

22、验证IoTDB状态

kubectl get pods -n iotdb-ns -o wide# NAME  READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES# confignode-0 1/1 Running 0 75m 10.20.187.14 a87   # confignode-1 1/1 Running 0 75m 10.20.191.75 a88   # confignode-2 1/1 Running 0 75m 10.20.187.16 a87   # datanode-0 1/1 Running 10 (5m54s ago) 75m 10.20.191.74 a88   # datanode-1 1/1 Running 10 (5m42s ago) 75m 10.20.187.15 a87   # datanode-2 1/1 Running 10 (5m55s ago) 75m 10.20.191.76 a88   # datanode-3 1/1 Running 10 (5m55s ago) 75m 10.20.191.76 a88

Apache IoTDB CRUD 操作

创建时间序列（Schema）

-- 创建存储组（逻辑分区）CREATE STORAGE GROUP root.device;-- 创建时间序列（带数据类型和编码）CREATE TIMESERIES root.device.temperature WITH DATATYPE=FLOAT, ENCODING=RLE;CREATE TIMESERIES root.device.humidity WITH DATATYPE=INT32, ENCODING=PLAIN;

写入数据（增）

INSERT INTO root.device(timestamp, temperature) VALUES(1690000000000, 25.5);

查询数据（查）

SELECT temperature FROM root.device WHERE time >= 1690000000000;

修改数据（改）

INSERT INTO root.device(timestamp, temperature) VALUES(1690000000000, 26.0); -- 覆盖原有值

删除数据（删）

DELETE FROM root.device.temperature WHERE time < 1690000001000;

Timer 深度时序分析通用基础模型

在这里插入图片描述

Timer 深度时序分析通用基础模型是由清华大学软件学院研发的新一代时序分析框架，专为解决物联网、工业互联网等场景下的复杂时序数据深度解析需求而设计。其核心价值在于通过生成式预训练与统一任务建模，实现了时序数据从存储到分析的端到端智能化

✅少样本强适配：无需大量标注数据，通过预训练习得通用时序规律，少量领域样本即可快速适配新场景，泛化能力突出

✅全任务一体化：统一时序预测、缺失值填补、异常检测等多任务为生成式框架，灵活应对各类时序分析需求，无需单独建模

✅高扩展易升级：随参数量增加和训练数据扩容，模型对复杂时序模式的捕捉能力持续增强，适配数据规模与场景复杂度增长

总结

在这里插入图片描述

Apache IoTDB 是物联网时序数据管理的高效利器，高吞吐写入、极致压缩率与类 SQL 查询能力，能轻松应对传感器高频数据的存储与分析需求，通过 Kubernetes 部署全流程，提供可直接复用的操作手册，配合 CRUD 语法示例快速上手数据操作，结合 Timer 深度时序分析模型的少样本适配与全任务统一能力，开发者可快速搭建从底层存储到上层智能分析的完整链路，无需重复开发时序处理模块，无论是边缘设备轻量化部署，还是云端分布式集群扩展，这套方案都能降低物联网数据管理的技术门槛，让开发者专注于业务逻辑实现而非底层存储细节。

👉Apache IoTDB 下载地址👈（点击下载）

时序数据库 Apache IoTDB 实战：基于 Kubernetes 的部署运维全指南