FastAPI部署
Uvicorn
Uvicorn
是基于uvloop
和httptools
构建的非常快速的ASGI
服务器。Uvicorn
提供一个轻量级的方法来运行多个工作进程,比如-workers 4
,但是并没有提供进行的监控。
Gunicorn
Gunicorn
是成熟的,功能齐全的服务器,Uvicorn
内部包含有Gunicorn
的workers
类,允许你运行ASGI
应用程序,这些workers
继承了所有Uvicorn
高性能的特点,并且给你使用Gunicorn
来进行进程管理。- 用来管理
Uvicorn
使用Gunicorn和Uvicorn的worker类生产环境部署
1、Liunx命令行后台启动
nohup gunicorn -c main:app --host 0.0.0.0 --port 8080 -w 4 -k uvicorn.workers.UvicornWorker
2、 docker部署
2.1. Gunicorn配置文件(gunicorn.conf.py)
import multiprocessing
# 是否开启debug
debug = True
# 设置守护进程
# daemon = True
# 绑定ip和端口号
bind = '0.0.0.0:8000'
# 超时时间
timeout = 30
# 工作模式
worker_class = 'uvicorn.workers.UvicornWorker'
# 进程数
workers = multiprocessing.cpu_count() * 2 + 1
# 设置证书
# keyfile = ''
# certfile = ''
# 日志级别,这个日志级别指的是错误日志级别,而访问日志的级别无法设置
loglevel = 'debug'
# 日志配置
# 访问日志文件
accesslog = "/tmp/gunicorn_fasttest_access.log"
# 错误日志文件
errorlog = "/tmp/gunicorn_fasttest_error.log"
# OR
# 配置文件方式配置日志
# logconfig = "./logger.ini"
2.2 Dockerfile文件
- 需要先进行安装所需系统依赖()
- 然后安装python依赖包
- 指定容器中可以暴露的端口(EXPOSE)
- 运行容器时,需要执行的命令(ENTRYPOINT)
-preload
此参数可查看详细的报错信息
FROM python:3.8.5
LABEL author="Desire"
LABEL desc="web fastapi"
COPY . /app
WORKDIR /app
RUN apt-get update && apt-get install -y build-essential gcc libc-dev make python3-lxml \\
&& pip install -r requirements.txt -i <http://mirrors.aliyun.com/pypi/simple>
EXPOSE 8000
ENTRYPOINT ["gunicorn", "--preload", "-c", "gunicorn.conf.py", "main:app"]
2.3 构建镜像
docker build -t fastapi_gunicorn:v1 -f Dockerfile .
2.4 运行容器
docker run -di -p 8000:8000 --name fastapi_gunicorn fastapi_gunicorn:v1
2.5 小拓
1)如果gunicorn.conf.py
文件和main.py
没有在同一个目录下
目录如下:
├── app
│ └── main.py
├── Dockerfile
├── gunicorn.conf.py
├── requirements.txt
└── start.sh
2)启动的时候可以使用shell脚本(start.sh)
进行启动
- 先进入到main.py目录
- 指定启动配置文件时使用
../gunicorn.conf.py
表示上一级目录下的gunicorn.conf.py
cd app
gunicorn --preload -c ../gunicorn.conf.py main:app
3)Dockerfile只需要把启动命令换成执行shell脚本即可
ENTRYPOINT [ "bash", "start.sh" ]
2.6 导包问题
报错原因:
- 入口文件放在app文件夹中,启动时的寻包路径就从app开始了,所以找不到包
解决:
- 把入口文件main.py放到项目根目录下