使用Docker部署Chatbot NER服务的完整指南

项目概述

Chatbot NER是一个用于聊天机器人中的命名实体识别(NER)服务，能够从用户输入中识别和提取关键信息，如日期、时间、地点等实体。本文将详细介绍如何使用Docker容器化技术来部署这一服务。

环境准备

Docker安装

Ubuntu系统安装步骤

1. 更新系统软件包并安装依赖项：

   sudo apt-get -y update
   sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
   

2. 添加Docker官方GPG密钥：

   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
   

3. 设置稳定版仓库：

   sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
   

4. 安装Docker CE：

   sudo apt-get update
   sudo apt-get install docker-ce
   

5. 将当前用户加入docker组：

   sudo usermod -aG docker $USER
   

Docker Compose安装

sudo curl -L "https://github.com/docker/compose/releases/download/1.22.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

项目部署流程

1. 获取项目代码

将chatbot_ner项目克隆到本地：

git clone https://github.com/hellohaptik/chatbot_ner.git
cd chatbot_ner
cp ./dev_docker/* ./

2. 配置环境变量

1. 复制示例环境文件：

   cp .env.example .env
   

2. 修改.env文件：

   • 必须修改SECRET_KEY值
   • 根据实际需求调整其他配置参数

3. 设置entrypoint.sh执行权限：

   sudo chmod 777 entrypoint.sh
   

3. 启动服务容器

构建并启动Docker容器：

docker-compose up --build -d

4. 验证服务状态

检查容器运行状态：

docker-compose ps

如果Elasticsearch容器不断重启，可能是权限问题导致，需要执行以下操作：

1. 停止容器：

   docker-compose down
   

2. 设置数据目录权限：

   sudo chmod -R 777 ./dbdata/esdata/v1
   

3. 重新启动容器：

   docker-compose up --build -d
   

服务管理与监控

常用容器命令

• 查看运行中的容器：

  docker-compose ps
  

• 进入容器shell：

  docker exec -it container-name bash
  

• 停止容器：

  docker-compose down
  

• 重启容器：

  docker-compose restart
  

日志查看

查看容器日志：

docker logs -f docker_chatbot-ner_1

或者直接查看日志文件：

cd ~/chatbot_ner/logs
tail -f *.log

服务测试

API调用示例

测试实体识别功能：

URL='localhost'
PORT=8081
curl -i 'http://'$URL':'$PORT'/v1/ner/?entities=\[%22date%22,%22time%22,%22restaurant%22\]&message=Reserve%20me%20a%20table%20today%20at%206:30pm%20at%20Mainland%20China%20and%20on%20Monday%20at%207:00pm%20at%20Barbeque%20Nation'

预期返回结果将包含识别出的日期、时间和餐厅实体信息。

图形界面访问

通过浏览器访问图形界面：

http://localhost:8081/gui/

自定义镜像构建

如需构建自定义Docker镜像：

cd chatbot_ner/docker
sudo docker build -t ner_image .
sudo docker run -itd -p 8081:80 --name ner ner_image

注意事项

1. 确保8081端口未被占用，如需释放端口：

   sudo lsof -t -i tcp:8081 -s tcp:listen | sudo xargs kill
   

2. 重新启动容器时，datastore_setup.py会再次执行。如需保留Elasticsearch中的数据，请注释掉datastore_setup.py中的DataStore部分。

3. 服务启动后，建议等待5秒再发起首次API调用，确保所有组件已完成初始化。

通过以上步骤，您应该能够成功部署并运行Chatbot NER服务。如需进一步定制或扩展功能，可以参考项目文档进行深入配置。