1. 程式人生 > 其它 >flask 部署筆記

flask 部署筆記

python web 部署

web開發中,各種語言爭奇鬥豔,web的部署方面,卻沒有太多的方式。簡單而已,大概都是 nginx 做前端代理,中間 webservice 呼叫程式指令碼。大概方式:nginx + webservice + script

nginx 不用多說,一個高效能的web伺服器。通常用來在前端做反向代理伺服器。所謂正向與反向(reverse),只是英文說法翻譯。代理服務,簡而言之,一個請求經過代理伺服器從區域網發出,然後到達網際網路上伺服器,這個過程的代理為正向代理。如果一個請求,從網際網路過來,先進入代理伺服器,再由代理伺服器轉發給區域網的目標伺服器,這個時候,代理伺服器為反向代理(相對正向而言)。

正向代理:{ 客戶端 ---》 代理伺服器 } ---》 伺服器

反向代理:客戶端 ---》 { 代理伺服器 ---》 伺服器 }

{} 表示區域網

nginx既可以做正向,也可以做反向。
webservice 的方式同樣也有很多方式。常見的有FastCGIWSGI等。我們採用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 依賴兩個庫werkzeugjinjia2

。採用 pip 方式安裝即可。

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 部屬已經完成。