简体中文 | English
Paddle Serving 旨在帮助深度学习开发者轻松部署在线预测服务,支持一键部署工业级的服务能力、客户端和服务端之间高并发和高效通信、并支持多种编程语言开发客户端。
该部分以 HTTP 预测服务部署为例,介绍怎样在 PaddleVideo 中使用 PaddleServing 部署模型服务。目前只支持 Linux 平台部署,暂不支持 Windows 平台。
Serving 官网推荐使用 docker 安装并部署 Serving 环境。首先需要拉取 docker 环境并创建基于 Serving 的 docker。
# 启动GPU docker
docker pull paddlepaddle/serving:0.7.0-cuda10.2-cudnn7-devel
nvidia-docker run -p 9292:9292 --name test -dit paddlepaddle/serving:0.7.0-cuda10.2-cudnn7-devel bash
nvidia-docker exec -it test bash
# 启动CPU docker
docker pull paddlepaddle/serving:0.7.0-devel
docker run -p 9292:9292 --name test -dit paddlepaddle/serving:0.7.0-devel bash
docker exec -it test bash
进入 docker 后,需要安装 Serving 相关的 python 包。
python3.7 -m pip install paddle-serving-client==0.7.0
python3.7 -m pip install paddle-serving-app==0.7.0
python3.7 -m pip install faiss-cpu==1.7.1post2
#若为CPU部署环境:
python3.7 -m pip install paddle-serving-server==0.7.0 # CPU
python3.7 -m pip install paddlepaddle==2.2.0 # CPU
#若为GPU部署环境
python3.7 -m pip install paddle-serving-server-gpu==0.7.0.post102 # GPU with CUDA10.2 + TensorRT6
python3.7 -m pip install paddlepaddle-gpu==2.2.0 # GPU with CUDA10.2
#其他GPU环境需要确认环境再选择执行哪一条
python3.7 -m pip install paddle-serving-server-gpu==0.7.0.post101 # GPU with CUDA10.1 + TensorRT6
python3.7 -m pip install paddle-serving-server-gpu==0.7.0.post112 # GPU with CUDA11.2 + TensorRT8
- 如果安装速度太慢,可以通过
-i https://pypi.tuna.tsinghua.edu.cn/simple
更换源,加速安装过程 - 更多环境和对应的安装包详见:https://github.com/PaddlePaddle/Serving/blob/v0.9.0/doc/Install_Linux_Env_CN.md
使用 PaddleServing 做服务化部署时,需要将保存的 inference 模型转换为 Serving 模型。下面以 PP-TSM 模型为例,介绍如何部署行为识别服务。
-
下载训练好的 PP-TSM 的模型,并转化为推理模型:
# 进入PaddleVideo目录 cd PaddleVideo wget -P data/ https://videotag.bj.bcebos.com/PaddleVideo-release2.1/PPTSM/ppTSM_k400_uniform.pdparams python3.7 tools/export_model.py \ -c configs/recognition/pptsm/pptsm_k400_frames_uniform.yaml \ -p data/ppTSM_k400_uniform.pdparams \ -o inference/ppTSM
-
我们也提供了转换好的推理模型,按以下命令下载并解压
mkdir ./inference wget -nc -P ./inference https://videotag.bj.bcebos.com/PaddleVideo-release2.3/ppTSM.zip --no-check-certificate pushd ./inference unzip ppTSM.zip popd
-
用 paddle_serving_client 把转换好的推理模型再转换成易于 Server 部署的模型格式:
python3.7 -m paddle_serving_client.convert \ --dirname inference/ppTSM \ --model_filename ppTSM.pdmodel \ --params_filename ppTSM.pdiparams \ --serving_server ./deploy/python_serving/ppTSM_serving_server/ \ --serving_client ./deploy/python_serving/ppTSM_serving_client/
参数 类型 默认值 描述 dirname
str - 需要转换的模型文件存储路径,Program结构文件和参数文件均保存在此目录。 model_filename
str None 存储需要转换的模型Inference Program结构的文件名称。如果设置为None,则使用 __model__
作为默认的文件名params_filename
str None 存储需要转换的模型所有参数的文件名称。当且仅当所有模型参数被保>存在一个单独的二进制文件中,它才需要被指定。如果模型参数是存储在各自分离的文件中,设置它的值为None serving_server
str "serving_server"
转换后的模型文件和配置文件的存储路径。默认值为serving_server serving_client
str "serving_client"
转换后的客户端配置文件存储路径。默认值为serving_client
PP-TSM 推理模型转换完成后,会在当前文件夹多出 ppTSM_serving_server
和 ppTSM_serving_client
的文件夹,具备如下格式:
PaddleVideo/deploy/python_serving
├── ppTSM_serving_server
├── ppTSM.pdiparams
├── ppTSM.pdmodel
├── serving_server_conf.prototxt
└── serving_server_conf.stream.prototxt
├── ppTSM_serving_client
├── serving_client_conf.prototxt
└── serving_client_conf.stream.prototxt
得到模型文件之后,需要分别修改 ppTSM_serving_server
和 ppTSM_serving_client
下的文件 serving_server_conf.prototxt
,将 两份文件中fetch_var
下的 alias_name
均改为 outputs
备注: Serving 为了兼容不同模型的部署,提供了输入输出重命名的功能。这样,不同的模型在推理部署时,只需要修改配置文件的alias_name
即可,无需修改代码即可完成推理部署。
修改后的serving_server_conf.prototxt
如下所示:
feed_var {
name: "data_batch_0"
alias_name: "data_batch_0"
is_lod_tensor: false
feed_type: 1
shape: 8
shape: 3
shape: 224
shape: 224
}
fetch_var {
name: "linear_2.tmp_1"
alias_name: "outputs"
is_lod_tensor: false
fetch_type: 1
shape: 400
}
python_serving
目录包含了启动 pipeline 服务、C++ serving服务(TODO)和发送预测请求的代码,具体包括:
__init__.py
configs/xxx.yaml # 启动pipeline服务的配置文件
pipeline_http_client.py # http方式发送pipeline预测请求的python脚本
pipeline_rpc_client.py # rpc方式发送pipeline预测请求的python脚本
recognition_web_service.py # 启动pipeline服务端的python脚本
utils.py # 储存预测过程中常用的函数,如parse_file_paths, numpy_to_base64, video_to_numpy
- 进入工作目录:
cd deploy/python_serving
- 启动服务:
# 在当前命令行窗口启动并保持在前端
python3.7 recognition_web_service.py -n PPTSM -c configs/PP-TSM.yaml
# 在后台启动,过程中打印输出的日志会重定向保存到log.txt中
python3.7 recognition_web_service.py -n PPTSM -c configs/PP-TSM.yaml &>log.txt &
- 发送请求:
# 以http方式的发送预测请求并接受结果
python3.7 pipeline_http_client.py -i ../../data/example.avi
# 以rpc方式的发送预测请求并接受结果
python3.7 pipeline_rpc_client.py -i ../../data/example.avi
成功运行后,模型预测的结果会打印在 cmd 窗口中,结果如下:
# http方式打印的结果
{'err_no': 0, 'err_msg': '', 'key': ['label', 'prob'], 'value': ["['archery']", '[0.9907388687133789]'], 'tensors': []}
# rpc方式打印的结果
PipelineClient::predict pack_data time:1645631086.764019
PipelineClient::predict before time:1645631086.8485317
key: "label"
key: "prob"
value: "[\'archery\']"
value: "[0.9907388687133789]"
Q1: 发送请求后没有结果返回或者提示输出解码报错
A1: 启动服务和发送请求时不要设置代理,可以在启动服务前和发送请求前关闭代理,关闭代理的命令是:
unset https_proxy
unset http_proxy
Q2: 服务端启动后没有反应,一直停在start proxy service
不动
A2: 很可能是启动过程中遇到了问题,可以在./deploy/python_serving/PipelineServingLogs/pipeline.log
日志文件中查看详细报错信息
更多的服务部署类型,如 RPC 预测服务
等,可以参考 Serving 的github 官网