nginx+uwsgi+flask 簡(jiǎn)單部署記錄備忘
nginx & uwsgi & flask三者的關(guān)系
先看下這個(gè)結(jié)構(gòu)圖
圖中的幾個(gè)地方解釋:
nginx : 前端服務(wù)器 就是第一級(jí) 用來(lái)直接接受用戶請(qǐng)求的http服務(wù)器躏嚎。 一般收到請(qǐng)求常見的處理是轉(zhuǎn)發(fā)給本機(jī)的cgi(不管是古老的cgi還是fast cgi還是wsgi協(xié)議)處理或者轉(zhuǎn)發(fā)給其他機(jī)器上的nginx繼續(xù)路由處理因篇。
cgi / fast cgi /wsgi 協(xié)議層: 本質(zhì)上都是類似cgi的東西瓣铣,本質(zhì)就是規(guī)定了前端服務(wù)器(nginx)如何和cgi服務(wù)溝通。 其中fast cgi是現(xiàn)在比較常見的改良版cgi(具體先不展開)纵穿。 wsgi是python專用的一個(gè)cgi協(xié)議(雖然感覺就是python版的fast cgi,據(jù)說(shuō)性能吊打fast cgi 我差點(diǎn)就信了- , - )特幔。
uwsgi : 一個(gè)wsgi協(xié)議的實(shí)現(xiàn)。 入口是一個(gè)可執(zhí)行程序辰企。常用命令有三個(gè)
1 uWSGI 啟動(dòng)(以這個(gè)ini配置開始運(yùn)行):
uwsgi --ini xxx.ini
2 uwsgi 重啟:
uwsgi --reload xxx.pid
3 uwsgi 停止:
uwsgi --stop xxx.pid
通過(guò)這個(gè)東西风纠,我們只要準(zhǔn)備一個(gè)ini文件和一個(gè)符合規(guī)范的py入口文件就可以起來(lái)一個(gè)wsgi協(xié)議的cgi或者h(yuǎn)ttp服務(wù)器了±蚊常可以作為cgi(后端服務(wù)器)也可以直接作為http服務(wù)器
flask : 這個(gè)是web編程框架竹观。 本質(zhì)上uwsgi + py入口文件就可以搞完了。但是flask只是封裝了一些東西(寫uwsgi的py入口文件的時(shí)候加載這個(gè)包會(huì)更方便一些),比如web框架層的復(fù)雜路由規(guī)則處理(每次都在nginx那里配了reload不是很麻煩嘛~)臭增,比如支持一些其他的擴(kuò)展啥的懂酱。 但是本質(zhì)還是封裝,核心Flask這個(gè)類的重寫了call方法誊抛,使其可以作為py入口文件被uwsgi使用而已列牺。下面會(huì)再說(shuō)到.
先從uwsgi開始
首先pip安裝uwsgi,然后敲 which uwsgi 你會(huì)看到uwsgi的位置
這個(gè)就是uwsgi了 拗窃,怎么用呢瞎领。
要開始用uwsgi起一個(gè)cgi或者h(yuǎn)ttp服務(wù)。 你需要準(zhǔn)備2個(gè)東西并炮。
一個(gè)是啟動(dòng)一個(gè)uwsgi的配置文件(本篇使用ini)
一個(gè)是啟動(dòng)一個(gè)uwsgi的py入口文件默刚,里面需要包含一個(gè)包含2個(gè)參數(shù)的方法(不配置的話方法名默認(rèn)是application, 這個(gè)可以改 后面再看)
先看配置文件,簡(jiǎn)單注釋了下
其中 如果你起來(lái)是做cgi和nginx配合的就配置socket 如果是獨(dú)立做http服務(wù)就配置http項(xiàng)
wsgi-file 就是你的py入口文件
其他看注釋 = =
uwsgi的配置項(xiàng)有很多逃魄,詳情可以看文檔
官方文檔
https://uwsgi-docs.readthedocs.io/en/latest/Configuration.html
中文文檔
https://www.bookstack.cn/read/uwsgi-docs-2.0-zh/e7d161bfa19cced5.md
再看py文件
py文件是有規(guī)范的.比如這個(gè)
就是要有一個(gè)方法荤西,像上面那個(gè)ini沒(méi)有配置入口方法名,這里的默認(rèn)名字就是application
return就是你吐回去的http報(bào)文了伍俘,這里測(cè)試隨便寫個(gè)字符串測(cè)試用的邪锌。
啟動(dòng)
uwsgi --ini xxx.ini 上面提到的這個(gè)命令即可 xxx.ini 就是你的配置文件,啟動(dòng)參數(shù)都配在里面了癌瘾。
然后如果你是用http方式啟動(dòng)的話觅丰,你可以直接瀏覽器拼ip:port訪問(wèn)了
如果你是配socket項(xiàng) 接著往下走
nginx部分
首先安裝nginx
然后你需要一個(gè)配置,比如這樣的
這里nginx用的1234端口
啟動(dòng)參數(shù)同樣在配置里了妨退,比較重要的就是一些log目錄妇萄,還有2個(gè)uwsgi的路由配置
上圖 /hhh 表示: 本機(jī)ip:1234/hhh 的url都轉(zhuǎn)發(fā)給對(duì)應(yīng)配置的wsgi,其中include部分是一個(gè)路徑,nginx安裝完后/etc/nginx/這個(gè)目錄下會(huì)給你備好 fastcgi_params , uwsgi_params 之類的幾個(gè)文本咬荷,里面寫了一些對(duì)應(yīng)協(xié)議的環(huán)境變量名字約定我們引用就好.
uwsgi_pass 就是轉(zhuǎn)發(fā)的uwsgi監(jiān)聽的端口路徑(和你上面起的uwsgi一致就好)
然后就nginx -c xx.conf 就可以按這個(gè)配置啟動(dòng)了就vans了冠句。 = =
nginx 常用命令就是
nginx -c xx.conf 指定配置啟動(dòng)
nginx -s reload 重新reload配置
nginx -s stop 快速退出
nginx -s quit 優(yōu)雅退出(請(qǐng)求處理完了退出)
好了好了 然后你會(huì)發(fā)現(xiàn)本機(jī)ip:1234/hhh 已經(jīng)可以請(qǐng)求到你的uwsgi了(鏈路是先到1234端口的nginx,然后nginx轉(zhuǎn)發(fā)給監(jiān)聽9090端口uwsgi)
終于到flask了
抄完上面的作業(yè)幸乒,web服務(wù)已經(jīng)起來(lái)了 懦底。 但是我們寫業(yè)務(wù)代碼還是很麻煩。
比如一些url路由邏輯(你自己獲取url自己實(shí)現(xiàn)也可以罕扎,但是每次都寫一遍就很麻煩 = =聚唐,nginx也可以配但是你不會(huì)想每次加個(gè)新接口都去nginx里改配置reload一下這么搞的),還有一些flask給你封裝好 or 引入的模塊腔召。 比如通過(guò)jinja2模版方便的渲染一個(gè)html返回杆查,再比如flask-login 之類的,加上flask這個(gè)web框架你可以少寫很多代碼。
下面是flask的作業(yè):
準(zhǔn)備工作和uwsgi一樣(flask只是一個(gè)web框架和業(yè)務(wù)代碼我覺得可以算同一層= =宴咧,還是用uwsgi添加py入口啟動(dòng)的)
首先 一個(gè)配置
可以看到和單純裸的uwsgi版本其實(shí)是一樣的配置項(xiàng)目
關(guān)鍵的區(qū)別在于入口文件引入flask框架
可以看到 py文件里需要的就是創(chuàng)建一個(gè)Flask對(duì)象(這里起的名字叫app)然后配置里callable項(xiàng)填這個(gè)名字告訴uwsgi收到消息傳給這個(gè)方法執(zhí)行就好了根灯。app.route裝飾器用來(lái)生命每個(gè)接口對(duì)應(yīng)的url 和 get/post那些。
flask文檔快速入門
http://docs.jinkan.org/docs/flask/quickstart.html#a-minimal-application