flask 部署筆記
python web 部署
web開發中,各種語言爭奇鬥豔,web的部署方面,卻沒有太多的方式。簡單而已,大概都是 nginx 做前端代理,中間 webservice 呼叫程式指令碼。大概方式:nginx + webservice + script
nginx 不用多說,一個高效能的web伺服器。通常用來在前端做反向代理伺服器。所謂正向與反向(reverse),只是英文說法翻譯。代理服務,簡而言之,一個請求經過代理伺服器從區域網發出,然後到達網際網路上伺服器,這個過程的代理為正向代理。如果一個請求,從網際網路過來,先進入代理伺服器,再由代理伺服器轉發給區域網的目標伺服器,這個時候,代理伺服器為反向代理(相對正向而言)。
正向代理:{ 客戶端 ---》 代理伺服器 } ---》 伺服器
反向代理:客戶端 ---》 { 代理伺服器 ---》 伺服器 }
{} 表示區域網
nginx既可以做正向,也可以做反向。
webservice 的方式同樣也有很多方式。常見的有FastCGI
,WSGI
等。我們採用gunicorn
為 wsgi容器。python為伺服器script,採用flask
框架。同時採用supervisor管理伺服器程序。也就是最終的部署方式為:nginx + gunicorn + flask ++ supervisor
建立一個專案
mkdir myproject
建立 python 虛擬環境
virtualenv 可以說是 python 的一個大殺器。用來在一個系統中建立不同的 python 隔離環境。相互之間還不會影響,使用簡單到令人髮指。
(我的工作路徑是/home/rsj217/rsj217
)
mkdir myproject cd myproject virtualenv venv
建立了 venv 環境之後,啟用就可以了
source venv/bin/activate
安裝 python web 框架 ---flask
flask 是一個 python web micro framework。簡潔高效,使用也很簡單。flask 依賴兩個庫werkzeug
和jinjia2
pip install flask
測試我們的 flask 安裝是否成功,並使用 flask 寫一個簡單的 web 服務。
vim myapp.py
from flask import Flask app = Flask(__name__) @app.route('/') def index(): return 'hello world' if __name__ == '__main__': app.debug = True app.run()
啟動 flask
python myapp.py
此時,用瀏覽器訪問 http://127.0.0.1:5000 就能看到網頁顯示hello world
。
使用 gunicorn 部署 python web
現在我們使用 flask 自帶的伺服器,完成了 web 服務的啟動。生產環境下,flask 自帶的 伺服器,無法滿足效能要求。我們這裡採用 gunicorn 做 wsgi容器,用來部署 python。
安裝 gunicorn
pip install gunicorn
pip 是一個重要的工具,python 用來管理包。還有一個最佳生產就是每次使用 pip 安裝的庫,都寫入一個 requirement 檔案裡面,既能知道自己安裝了什麼庫,也方便別人部署時,安裝相應的庫。
pip freeze > requirements.txt
以後每次 pip 安裝了新的庫的時候,都需freeze 一次。
當我們安裝好 gunicorn 之後,需要用 gunicorn 啟動 flask,注意 flask 裡面的name裡面的程式碼啟動了 app.run(),這個含義是用 flask 自帶的伺服器啟動 app。這裡我們使用了 gunicorn,myapp.py 就等同於一個庫檔案,被 gunicorn 呼叫。
gunicron -w4 -b0.0.0.0:8000 myapp:app
此時,我們需要用 8000 的埠進行訪問,原先的5000並沒有啟用。其中 gunicorn 的部署中,,-w 表示開啟多少個 worker,-b 表示 gunicorn 開發的訪問地址。
想要結束 gunicorn 只需執行 pkill gunicorn,有時候還的 ps 找到 pid 程序號才能 kill。可是這對於一個開發來說,太過於繁瑣,因此出現了另外一個神器---supervisor
,一個專門用來管理程序的工具,還可以管理系統的工具程序。
安裝 supervisor
pip install supervisor echo_supervisord_conf > supervisor.conf # 生成 supervisor 預設配置檔案 vim supervisor.conf # 修改 supervisor 配置檔案,新增 gunicorn 程序管理
在myapp supervisor.conf 配置檔案底部新增 (注意我的工作路徑是/home/rsj217/rsj217/
)
[program:myapp] command=/home/rsj217/rsj217/myproject/venv/bin/gunicorn -w4 -b0.0.0.0:2170 myapp:app ; supervisor啟動命令 directory=/home/rsj217/rsj217/myproject ; 專案的資料夾路徑 startsecs=0 ; 啟動時間 stopwaitsecs=0 ; 終止等待時間 autostart=false ; 是否自動啟動 autorestart=false ; 是否自動重啟 stdout_logfile=/home/rsj217/rsj217/myproject/log/gunicorn.log ; log 日誌 stderr_logfile=/home/rsj217/rsj217/myproject/log/gunicorn.err ; 錯誤日誌
supervisor的基本使用命令
supervisord -c supervisor.conf 通過配置檔案啟動supervisor supervisorctl -c supervisor.conf status 察看supervisor的狀態 supervisorctl -c supervisor.conf reload 重新載入 配置檔案 supervisorctl -c supervisor.conf start [all]|[appname] 啟動指定/所有 supervisor管理的程式程序 supervisorctl -c supervisor.conf stop [all]|[appname] 關閉指定/所有 supervisor管理的程式程序
supervisor 還有一個web的管理介面,可以啟用。更改下配置
[inet_http_server] ; inet (TCP) server disabled by default port=127.0.0.1:9001 ; (ip_address:port specifier, *:port for all iface) username=user ; (default is no username (open server)) password=123 ; (default is no password (open server)) [supervisorctl] serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket serverurl=http://127.0.0.1:9001 ; use an http:// url to specify an inet socket username=user ; should be same as http_username if set password=123 ; should be same as http_password if set ;prompt=mysupervisor ; cmd line prompt (default "supervisor") ;history_file=~/.sc_history ; use readline history if available
現在可以使用 supervsior 啟動 gunicorn啦。執行命令supervisord -c supervisor.conf
訪問 http://127.0.0.1:9001 可以得到 supervisor的web管理介面,訪問 http://127.0.0.1:2170 可以看見gunciron 啟動的返回的 hello world
安裝配置 nginx
採用 apt-get方式安裝最簡單。執行sudo apt-get install nginx
。安裝好的nginx的二進位制檔案放在/usr/sbin/
資料夾下面。而nginx的配置檔案放在/etc/nginx
下面。
使用 supervisor 來管理 nginx。這裡需要注意一個問題,linux的許可權問題。nginx是sudo的方式安裝,啟動的適合也是 root使用者,那麼我們現在也需要用 root使用者啟動supervisor。增加下面的配置檔案
[program:nginx] command=/usr/sbin/nginx startsecs=0 stopwaitsecs=0 autostart=false autorestart=false stdout_logfile=/home/rsj217/rsj217/myproject/log/nginx.log stderr_logfile=/home/rsj217/rsj217/myproject/log/nginx.err
到此為止,進步的 web 部屬已經完成。