huangbosbos/iotdb

IoTDB Docker镜像文档

镜像概述

本镜像为IoTDB 0.13.3版本的容器化部署包。IoTDB是一款高性能时间序列数据库，专为海量时间序列数据的存储、查询和分析设计，广泛应用于物联网、工业监控等场景。通过Docker镜像可快速搭建IoTDB服务，简化部署流程并确保环境一致性。

核心功能与特性

• 便捷部署：通过Docker容器化部署，无需手动配置依赖环境
• 数据持久化：支持挂载本地目录实现数据和日志的持久化存储
• 客户端支持：内置命令行客户端，支持数据库连接与操作
• 版本固定：基于0.13.3稳定版本构建，确保服务一致性

使用场景

• 物联网（IoT）设备数据采集与存储
• 工业监控系统的时间序列数据管理
• 需要高效处理时间序列数据的应用场景

使用方法

1. 拉取镜像

从Docker仓库拉取IoTDB 0.13.3镜像：

bash
docker pull huangbosbos/iotdb:0.13.3

2. 运行容器

启动IoTDB容器，映射端口并挂载数据和日志目录：

bash
docker run --name iotdb -p 6667:6667 \
  -v /home/iotdb/data:/iotdb/data \
  -v /home/iotdb/logs:/iotdb/logs \
  -d huangbosbos/iotdb:0.13.3 /iotdb/sbin/start-server.sh

参数说明：

• --name iotdb：指定容器名称为iotdb
• -p 6667:6667：映射容器6667端口到主机（IoTDB默认服务端口）
• -v /home/iotdb/data:/iotdb/data：挂载主机数据目录到容器，实现数据持久化
• -v /home/iotdb/logs:/iotdb/logs：挂载主机日志目录到容器，实现日志持久化
• -d：后台运行容器
• /iotdb/sbin/start-server.sh：启动IoTDB服务的脚本路径

3. 执行客户端命令

通过以下方式启动IoTDB命令行客户端：

方法一：进入容器后执行

bash
docker exec -it iotdb bash
/iotdb/sbin/start-cli.sh -h 127.0.0.1 -p 6667 -u root -pw root

方法二：直接执行客户端命令

bash
docker exec -it iotdb bash /iotdb/sbin/start-cli.sh -h 127.0.0.1 -p 6667 -u root -pw root

成功连接后将显示客户端界面：

---------------------
Starting IoTDB Cli
---------------------
 _____       _________  ______   ______    
|_   _|     |  _   _  ||_   _ `.|_   _ \   
  | |   .--.|_/ | | \_|  | | `. \ | |_) |  
  | | / .'`\ \  | |      | |  | | |  __'.  
 _| |_| \__. | _| |_    _| |_.' /_| |__) | 
|_____|'.__.' |_____|  |______.'|_______/  version 0.13.3
                                           

IoTDB> login successfully
IoTDB> 

4. 镜像提交与推送（可选）

如需保存自定义配置，可将容器提交为新镜像并推送：

bash
docker commit \
  --author "Lucky <huangbosbos@gmail.com>" \
  --message "iotdb 0.13.3" \
  iotdb \
  huangbosbos/iotdb:0.13.3

docker push huangbosbos/iotdb:0.13.3

参数说明：

• --author：指定镜像作者信息
• --message：提交说明信息
• iotdb：源容器名称
• huangbosbos/iotdb:0.13.3：目标镜像名称及版本