关于docker部署fastapi项目以及日志挂载方式
作者:id老猫
docker部署fastapi项目以及日志挂载
最近在尝试用docker部署fastapi项目
他的基本架构是由nginx+guvicorn+uvicorn+fastapi项目组成的
Nginx
nginx起到反向代理的作用
可能有人会问,为什么要用nginx反向代理,我直接访问项目不行吗?
其实nginx不只是反向代理的功能,还有很多像负载均衡、请求拦截、静态文件访问等等功能,而且他还隐藏了web服务的地址。
uvicorn
uvicorn是什么呢?大家都知道,fastapi使用的是ASGI协议,它是WSGI协议的一种升级版
而uvicorn是一个高性能的ASGI服务器,它建立在uvloop和httptools之上,
我们在本地开发时可以使用uvicorn来做服务器,
不过虽然uviorn也可以启动和运行多个进程,但是在处理工作进程的能力上更有限。
gunicorn
所以我使用gunicorn来做进程管理器,虽然gunicorn是一个WSGI服务器,本身与fastapi不兼容,但是你只要告诉它使用哪个特定的工作进程类,他就可以使用这个类启动一个或多个工作进程
这不就巧了吗?uvicorn就有一个gunicorn兼容的worker类
下面我们来讲一下究竟怎么启动
首先我们需要下载uvicorn和gunicorn
pip install "uvicorn[standard]"
pip install gunicorn
然后我们就可以启动了
不过官方展示的是命令行启动:
gunicorn main:app --workers 4 --worker-class uvicorn.workers.UvicornWorker --bind 0.0.0.0:80
并没有展示文件启动的方式,我们还是习惯配置文件启动,其实也很简单。
我们只需要在项目根路径下建立一个config.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' #设置执行路径 chdir = './sql_app' # 日志配置 # 访问日志文件 accesslog = "/app/sql_app/log/access.log" # 错误日志文件 errorlog = "/app/sql_app/log/error.log"
这里我们只要把worker_class 工作模式设置成’uvicorn.workers.UvicornWorker’,他就可以启动我们的uvicorn服务器了。
注意设置好执行路径和日志文件
然后执行启动命令
gunicorn -c config.py main:app
其中main为项目的初始化文件
docker日志挂载的问题
关键是本地服务器没有写入的权限
关键看这里吧(Permission denied), 一直没有看正方,以为是配置日志文件 找不到有问题,下面是部分异常
10:35:09,498 |-ERROR in ch.qos.logback.core.rolling.RollingFileAppender[FILE] - openFile(null,true) call failed. java.io.FileNotFoundException: logs/bandwidth.log.2019-04-25.log (Permission denied)
at java.io.FileNotFoundException: logs/bandwidth.log.2019-04-25.log (Permission denied)
at at java.io.FileOutputStream.open0(Native Method)
at at java.io.FileOutputStream.open(FileOutputStream.java:270)
at at java.io.FileOutputStream.<init>(FileOutputStream.java:213)
at at ch.qos.logback.core.recovery.ResilientFileOutputStream.<init>(ResilientFileOutputStream.java:26)
at at ch.qos.logback.core.FileAppender.openFile(FileAppender.java:204)
at at ch.qos.logback.core.FileAppender.start(FileAppender.java:127)
at at ch.qos.logback.core.rolling.RollingFileAppender.start(RollingFileAppender.java:100)
at at ch.qos.logback.core.joran.action.AppenderAction.end(AppenderAction.java:90)
at at ch.qos.logback.core.joran.spi.Interpreter.callEndAction(Interpreter.java:309)
at at ch.qos.logback.core.joran.spi.Interpreter.endElement(Interpreter.java:193)
尝试好多遍,才真正看懂原因也是从网上看到的一点启发,希望大家也能注意到,我用如下命令完美解决
docker run -it --privileged=true -v /dockerlogs:/app/logs -d -p 5080:5080 82edb4bbc79b
挂载宿主机已存在目录后,在容器内对其进行操作,报“Permission denied”
可通过两种方式解决:
1> 关闭selinux。
临时关闭:# setenforce 0
永久关闭:修改/etc/sysconfig/selinux文件,将SELINUX的值设置为disabled。
2> 以特权方式启动容器
指定--privileged参数
如:
# docker run -it --privileged=true -v /test:/softlogs
总结
以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。