homework-jianmu/docs/zh/06-advanced/06-TDgpt/02-tutorial.md

4.4 KiB
Raw Blame History

title sidebar_label
安装部署 安装部署

import PkgListV3 from "/components/PkgListV3";

使用 TDgpt Docker 镜像

本节首先介绍如何通过 Docker 快速使用 TDgpt。

启动 TDgpt

如果已经安装了 Docker首先拉取最新的 TDengine 容器镜像:

docker pull tdengine/tdengine:latest

或者指定版本的容器镜像:

docker pull tdengine/tdengine:3.3.3.0

然后只需执行下面的命令:

docker run -d -p 6030:6030 -p 6041:6041 -p 6043:6043 -p 6044-6049:6044-6049 -p 6044-6045:6044-6045/udp -p 6060:6060 tdengine/tdengine

注意TDgpt 服务端使用 6090 TCP 端口。TDgpt 是一个无状态时序数据分析智能体,并不会在本地持久化保存数据,仅根据配置可能在本地生成运行日志。

确定该容器已经启动并且在正常运行。

docker ps

进入该容器并执行 bash

docker exec -it <container name> bash

然后就可以执行相关的 Linux 命令操作和访问 TDengine。

注册云服务使用 TDgpt

TDgpt 可以在 TDengine Cloud 上进行快速体验。如果您已经有云服务账号,请在数据库集市里面找到“时序数据预测分析数据集”数据库,点击启用就可以进入这个数据库,然后按照 TDgpt 的 SQL 操作手册来执行语句,比如 select forecast(val, 'algo=tdtsfm_1') from forecast.electricity_demand;

通过安装包部署 TDgpt

环境准备

使用 TDgpt 的高级时序数据分析功能需要在 TDengine 集群中安装部署Taos AI nodeAnode。Anode 运行在 Linux 平台上,并需要 3.10 或以上版本的 Python 环境支持。

部署 Anode 需要 TDengine 3.3.6.0 及以后版本,请首先确认搭配 Anode 使用的 TDengine 能够支持 Anode。 因为使用 uWSGI所以需要环境有 C 编译器。

可以使用以下的命令在 Ubuntu Linux 上安装 Python 3.10 环境

安装 Python

sudo apt-get install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.10
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 2
sudo update-alternatives --config python3
sudo apt install python3.10-venv
sudo apt install python3.10-dev

安装 PiPy

curl -sS https://bootstrap.pypa.io/get-pip.py | python3.10

~/.local/bin 路径添加到环境变量中 ~/.bashrc or ~/.bash_profile

export PATH=$PATH:~/.local/bin

至此 Python 环境准备完成,可以进行 taosanode 的安装和部署。

安装 C 编译器

sudo apt update
sudo apt install build-essential

获取安装包

  1. 从列表中下载获得 tar.gz 安装包:

  2. 进入到安装包所在目录,使用 tar 解压安装包;

请将 <version> 替换为下载的安装包版本

tar -zxvf TDengine-TDgpt-<version>-Linux-x64.tar.gz

执行安装脚本

解压文件后,进入相应子目录,执行其中的 install.sh 安装脚本: 请将 <version> 替换为下载的安装包版本

cd TDengine-TDgpt-<version>
./install.sh

为了避免影响系统已有的 Python 环境Anode 使用虚拟环境运行。安装 Anode 会在目录 /var/lib/taos/taosanode/venv/ 中创建默认的 Python 虚拟环境Anode 运行所需要的库均安装在该目录下。为了避免反复安装虚拟环境带来的开销,卸载命令 rmtaosanode 并不会自动删除该虚拟环境,如果您确认不再需要 Python 的虚拟环境,手动删除该目录即可。

激活使用虚拟环境

为了避免安装操作系统的Python 环境, TDgpt 安装过程中会自动创建一个虚拟环境,该虚拟环境默认创建的路径在 /var/lib/taos/taosanode/venv/。创建完成该虚拟环境,该虚拟环境通过 PiPy 安装了支持 TDgpt 运行所必须的 Python 依赖库。 该虚拟环境不会被卸载脚本 rmtaosanode 删除,当您确认不再需要该虚拟环境的时候,需要手动删除该虚拟环境。 后续如果您需要开发自己的算法模型,并能够 TDgpt 正确调用,需要将新的依赖库通过虚拟环境的 Pip 正确地安装。

卸载

卸载 TDgpt执行 rmtaosanode 即可。 安装过程中自动安装的虚拟环境不会被自动删除,用户确认不再需要的时候,需要手动删除该虚拟环境。