Skip to content

Latest commit

 

History

History
185 lines (156 loc) · 8.14 KB

readme.md

File metadata and controls

185 lines (156 loc) · 8.14 KB

简体中文 | English

模型服务化部署

简介

Paddle Serving 旨在帮助深度学习开发者轻松部署在线预测服务,支持一键部署工业级的服务能力、客户端和服务端之间高并发和高效通信、并支持多种编程语言开发客户端。

该部分以 HTTP 预测服务部署为例,介绍怎样在 PaddleVideo 中使用 PaddleServing 部署模型服务。目前只支持 Linux 平台部署,暂不支持 Windows 平台。

Serving 安装

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

行为识别服务部署

模型转换

使用 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_serverppTSM_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_serverppTSM_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

Python Serving

  • 进入工作目录:
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]"

FAQ

Q1: 发送请求后没有结果返回或者提示输出解码报错

A1: 启动服务和发送请求时不要设置代理,可以在启动服务前和发送请求前关闭代理,关闭代理的命令是:

unset https_proxy
unset http_proxy

Q2: 服务端启动后没有反应,一直停在start proxy service不动

A2: 很可能是启动过程中遇到了问题,可以在./deploy/python_serving/PipelineServingLogs/pipeline.log日志文件中查看详细报错信息

更多的服务部署类型,如 RPC 预测服务 等,可以参考 Serving 的github 官网