跳到主要内容

安装部署

本节介绍如何通过 Docker,云服务或安装包来部署 TDgpt

镜像版本说明

镜像名称包含模型
tdengine/tdengine-tdgpt涛思时序数据基础模型(TDtsfm v1.0)
tdengine/tdengine-tdgpt-full涛思时序数据基础模型(TDtsfm v1.0)+ Time-MoE 时序数据基础模型

快速启动指南

您需要先安装 Docker,然后通过如下方式获取镜像并启动容器。

标准版镜像

拉取最新的 TDgpt 标准版容器镜像:

docker pull tdengine/tdengine-tdgpt:latest

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

docker pull tdengine/tdengine-tdgpt:3.3.6.0

执行下面的命令启动容器:

docker run -d -p 6090:6090 -p 5000:5000 tdengine/tdengine-tdgpt:3.3.6.0

完整版镜像

拉取最新的 TDgpt 容器镜像:

docker pull tdengine/tdengine-tdgpt-full:latest

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

docker pull tdengine/tdengine-tdgpt-full:3.3.6.0

执行下面的命令启动容器:

docker run -d -p 6090:6090 -p 5000:5000 -p 5001:5001 tdengine/tdengine-tdgpt-full:3.3.6.0

注意:TDgpt 服务端使用 6090 TCP 端口。5000 和 5001 端口分别标准版中涛思时序基础模型服务端口和完整版中 Time-MoE 本地服务的端口;

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

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 node(Anode)。Anode 运行在 Linux 平台上, 对部署 Anode 的有一定的环境要求:

  • Python: 3.10 或以上版本。
  • TDengine:需使用 3.3.6.0 或以上版本。
  • C 编译器:因依赖 uWSGI,部署环境需包含 C 编译器。

使用如下命令在 Ubuntu Linux 上安装 Python 3.10 环境。如果您的系统环境中已经有 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

安装 pip

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 安装包

      安装包中包含两个时序基础模型:涛思时序基础模型(TDtsfm v1.0)和 Time-MoE 时序基础模型。两个基础时序模型启动时候需要一定的内存空间,请确保安装机器至少有 16GiB 可用内存。

    • 进入到安装包所在目录,使用 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/

    • 创建完成该虚拟环境,该虚拟环境通过 pip 安装支持 TDgpt 运行所必须的 Python 依赖库。

    • 该虚拟环境不会被卸载脚本 rmtaosanode 删除,当您确认不再需要该虚拟环境的时候,需要手动删除该虚拟环境。

    • 后续如果您需要开发自己的算法模型,并整合到 TDgpt 中,需要通过虚拟环境中的 pip 安装新依赖库。

    卸载

    卸载 TDgpt,执行 rmtaosanode 即可。

    安装过程中自动安装的虚拟环境不会被自动删除,用户确认不再需要的时候,需要手动删除该虚拟环境。