docker安装管理TDengine
- 一、docker安装
- 二、docker安装管理TDengine
-
- [2.1 docker安装TDEngine镜像](#2.1 docker安装TDEngine镜像)
- [2.2 docker管理TDEngine](#2.2 docker管理TDEngine)
- [2.3 TDEngine配置](#2.3 TDEngine配置)
-
- [2.3.1 taos.cfg](#2.3.1 taos.cfg)
- [2.3.2 explorer.toml](#2.3.2 explorer.toml)
- [2.3.3 taosadapter.toml](#2.3.3 taosadapter.toml)
- [2.3.4 taoskeeper.toml](#2.3.4 taoskeeper.toml)
- [2.3.5 taosx.toml](#2.3.5 taosx.toml)
- [2.4 TDEngine容器重建](#2.4 TDEngine容器重建)
一、docker安装
二、docker安装管理TDengine
2.1 docker安装TDEngine镜像
通过docker安装TDEngine有两种方式:一种是在线通过docker hub安装;另一种是离线方式安装,详细如:
-
在线通过docker hub安装:
- 拉取最新版本的 TDengine TSDB-Enterprise 镜像:
docker pull tdengine/tsdb-ee:latest - 拉取指定版本的 TDengine TSDB-Enterprise 镜像:
docker pull tdengine/tsdb-ee:3.4.0.0
- 拉取最新版本的 TDengine TSDB-Enterprise 镜像:
-
离线方式安装 :
- 下载镜像包:【点击进入下载地址】
- 上传镜像到指定目录
- 通过docker导入镜像:
docker load -i 镜像名称.tar.gz
sudo docker load -i tdengine-tsdb-enterprise-docker-3.4.0.0-linux-x64.tar.gz

- 验证docker安装是否成功,查看当前镜像:
sudo docker images

回到目录
2.2 docker管理TDEngine
-
创建TDEngine外部taos数据文件目录:
sudo mkdir -p /juxin/taos/data
sudo mkdir -p /juxin/taos/log
sudo mkdir -p /juxin/taos/conf
sudo chmod 777 /juxin/taos/data
sudo chmod 777 /juxin/taos/log
sudo chmod 777 /juxin/taos/conf -
启动 TDengine TSDB容器化 :
这种方式为部署 TDengine TSDB 提供了更大的灵活性。
- -d:后台运行
- --name tdengine:(可选)定义容器名称
- --restart=always :(可选)定义docker启动时容器自启动
- -v /juxin/taos/data:(可选)数据持久化,映射容器外部taos数据文件目录,可通过配置文件修改位置。
- -v /juxin/taos/log:(可选)数据持久化,映射容器外部taos日志文件目录,可通过配置文件修改位置。
- taosd -c /juxin/taos/taos.cfg: (可选)自定义配置文件挂载(需提前准备taos.cfg)
- -p 6041: REST端口映射
- -p 6030:6030 :客户端端口映射
- -p 6060:6060 : taosExplorer可视化管理工具端口映射
如果主机上该端口段已经被占用,可以修改上述命令以指定一个主机上空闲的端口段。
sudo docker run -d \
--name tdengine --restart=always \
-v /juxin/taos/data:/var/lib/taos \
-v /juxin/taos/log:/var/log/taos \
-p 6030:6030 \
-p 6041:6041 \
-p 6043:6043 \
-p 6044-6049:6044-6049 \
-p 6044-6045:6044-6045/udp \
-p 6060:6060 \
tdengine/tsdb-ee-amd64:3.4.0.0
- 查看容器信息:
sudo docker ps

其他docker管理容器命令:
- 关闭容器:
sudo docker stop 容器名/容器ID- 删除容器:
sudo docker rm 容器名/容器ID- 查看运行状态:
sudo docker exec tdengine taos -s "SHOW DNODES;"- 查看连接情况:
sudo docker exec tdengine taos -s "SHOW CONNECTIONS;"- 查看资源使用:
sudo docker stats tdengine
- 验证该容器中提供的 HTTP 服务是否可用:
curl -u root:taosdata -d "show databases" localhost:6041/rest/sql

- 在容器中访问 TDengine TSDB(即数据库命令行):
sudo docker exec -it tdengine taos

回到目录
2.3 TDEngine配置
- 查看主机名称:
hostname

- 将配置文件复制到宿主机 /juxin/taos/conf 目录:
sudo docker cp tdengine:/etc/taos/. /juxin/taos/conf/
2.3.1 taos.cfg
- 对应组件:TDengine 核心数据库引擎(taosd)
- 作用:是 TDengine 最核心的配置文件,控制数据库本身的所有核心参数(比如端口、存储路径、集群配置、日志级别等),你之前问的 debugFlag 就属于这个文件的配置项。
- 修改配置文件:
vi /juxin/taos/conf/taos.cfg

2.3.2 explorer.toml
- 对应组件:TDengine 可视化管理工具(taosExplorer)
- 作用:配置可视化管理界面的参数(比如访问端口、登录权限、界面语言等),用于通过网页端管理 TDengine 集群。
- 修改配置文件:
vi /juxin/taos/conf/explorer.toml

回到目录
2.3.3 taosadapter.toml
- 对应组件:TDengine 适配器(taosAdapter)- 客户端
- 作用:配置应用与 TDengine 之间的适配参数(比如 RESTful API 端口、MQTT 协议转发、第三方工具(如 Grafana)的适配规则等),是应用访问 TDengine 的 "桥梁"。
- 修改配置文件:
vi /juxin/taos/conf/taosadapter.toml

回到目录
2.3.4 taoskeeper.toml
- 对应组件:TDengine 监控指标导出工具(taosKeeper)
- 作用:配置监控数据的采集、存储规则(比如监控指标类型、上报频率、存储目标等),用于将 TDengine 的运行指标(如 CPU / 内存占用、查询性能)同步到监控平台。
- 修改配置文件:
vi /juxin/taos/conf/taoskeeper.toml

回到目录
2.3.5 taosx.toml
- 对应组件:TDengine 数据管道工具(taosX)
- 作用:配置数据同步 / 流转的参数(比如 Kafka/MQTT 数据源的对接、数据清洗规则、目标表映射等),用于实现 TDengine 与其他系统之间的数据传输。
- 修改配置文件:
vi /juxin/taos/conf/taosx.toml

回到目录
2.4 TDEngine容器重建
删除容器后,根据上面修改后的配置文件重新启动容器:
sudo docker stop tdengine && sudo docker rm tdengine
sudo docker run -d \
--name tdengine --restart=always \
-v /juxin/taos/data:/var/lib/taos \
-v /juxin/taos/log:/var/log/taos \
-v /juxin/taos/conf:/etc/taos \
-p 6030:6030 \
-p 6041:6041 \
-p 6043:6043 \
-p 6044-6049:6044-6049 \
-p 6044-6045:6044-6045/udp \
-p 6060:6060 \
tdengine/tsdb-ee-amd64:3.4.0.0

