本文将介绍如何部署 BI 规则模型和安装 BI 问答插件，对部署需求、部署步骤以及后续的版本更新提供了说明和指导。

2.1 BI 工程要求

在使用问答 BI 前，需要先在服务器上部署 BI 6.1及以上版本的工程。

1）若没有 BI 工程，需要先在服务器上部署 BI 工程，部署要求以及部署方法可参考：工程部署方案选择

2）若已有 BI 工程，使用超管账号登陆 FineBI 系统，点击「管理系统>注册管理>版本信息」，即可查看工程的版本号。若工程版本为 6.1 以下，请参考 FineBI 版本升级 将工程升级至 6.1及以上版本。

2.2 BI 规则模型要求

BI规则模型和 BI 工程建议分布部署在两台服务器上，若需要部署在同一台服务器上请注意预留出足够的空间。

BI 规则模型部署环境要求如下表所示：

1）获取 「镜像」：下载镜像文件

2）获取「代码」压缩包：联系运营获取

3）获取 「问答BI 插件」：联系运营获取

4）2024/11/20 之前安装过规则模型的用户，需要先删除历史镜像：

docker stop chat2chart                                 #停止名为 chat2chart 的 Docker 容器

docker rm chat2chart                                    #删除该容器

docker rmi chat2chart_base:v1.5                   #删除 v1.5版本的镜像文件，释放磁盘空间

4.1 安装 Docker

安装步骤中需要使用到 Docker，请先检查服务器中是否已完成安装 Docker，检查 Docker 命令：docker --version

• 若没有安装则会显示 command not found，如下图所示，此时则需要在服务器上安装 Docker，安装步骤可参考：Linux系统安装Docker

• 若已安装则会显示 Docker 的版本信息，如下图所示：

4.2 安装镜像

1）将 「镜像」上传到服务器中指定的文件夹中

示例上传文件夹路径为：/home/AI

注：直接上传，上传后不要解压！！！

2）使用命令进入到文件夹路径，命令为：cd 文件夹路径

示例代码：cd /home/AI

3）检查文件

示例代码：ls

3）运行镜像文件，命令为：docker load -i 镜像文件压缩包

示例代码：docker load -i chat2chart_base_v1_5.tar

4）运行完成后，使用命令检查，出现镜像的名称和版本号即为完成，命令为：docker images

示例代码：docker images

5）使用命令运行镜像，命令为：docker run -it --name chat2chart -d -p 8666:8666 基础镜像名称:基础镜像版本号

示例代码：docker run -it --name chat2chart -d -p 8666:8666 chat2chart_base:v1.4

6）使用命令检查容器，命令为：docker ps

4.3 安装代码

1）将获取的代码文件 encrypt_XXXX.tar 包上传至服务器，之后再解压。命令为：tar -xvf 代码文件路径/代码文件名称

示例代码：tar -xvf /home/AI/encrypt_v1_5_1.tar

2）将代码文件放置到镜像中，命令为：docker cp 代码文件路径/代码文件名称 chat2chart:/root/

示例代码：docker cp /home/AI/encrypt_v1_5_1/ chat2chart:/root/

3）进入镜像的 /bin/bash 文件夹中，命令为：docker exec -it 镜像名称 /bin/bash

示例代码：docker exec -it chat2chart /bin/bash

4）进入代码文件夹，命令为：cd /root/代码文件名称/pipeline/

示例代码：cd /root/encrypt_v1_5_1/pipeline/

5）运行代码，命令为：python app.py

示例代码：python app.py

6)可直接关闭终端，或依次按下 Ctrl+P 和 Ctrl+Q 退出 Docker 容器

1）超管登录管理平台，选择「管理系统>插件管理>应用商城」，选择从本地安装获取的安装包，完成安装即可。

2）完成后刷新页面，选择「管理系统>智能问答配置」，配置 规则模型的 ip 地址和端口号（默认端口为8666），测试成功后，点击保存即可。

3）在管理系统右下角出现「问答BI」按钮即可完成，如下图所示：

需要分别更新镜像中的代码和工程中插件。

• 获取新版本「代码」压缩包

• 获取新版本 「问答BI 插件」安装包

6.1 更新代码

1）使用命令进入容器，命令为：docker exec -it 镜像名称 /bin/bash 

2）查看进程号，命令为：ps -ef | grep app.py 

3）关闭进程，命令为：kill -9 进程号

4）退出容器，命令为：exit

5）将获得的新代码压缩包上传到服务器中

6）将代码文件放置到镜像中，命令为：docker cp 代码文件路径/代码文件名称 chat2chart:/root/

7）进入镜像的 /bin/bash 文件夹中，命令为：docker exec -it 镜像名称 /bin/bash

8）进入代码文件夹，命令为：cd /root/代码文件名称/pipeline/

9）运行代码，令为：nohup python app.py &（终端显示nohup: ignoring input and appending output to 'nohup.out'命为正常现象）

6.2 更新插件

1）超管登录管理平台，选择「管理系统>插件管理>我的插件」。

2）选择从本地安装获取的新版本安装包，更新插件，即可完成。

3）清空缓存并刷新页面即可完成更新。

7.1 加载镜像时报错“no space left on device”

大概率因为 /var/lib/docker 被分配的硬盘空间不足。可执行 df -Th /var/lib/docker/ 查看被分配的空间大小。

解决办法：改变 docker data-root 路径

1）修改 /etc/docker/daemon.json 文件，没有则新建，并将 data-root 修改为硬盘空间充足的路径：

{
    "data-root": "/硬盘空间大的路径"
}

2）重启 docker