saecloud 依賴管理與 site-packages.zip 打包最佳實踐新浪 SAE(Sina App Engine)是國內早期 PaaS,雖有諸多限制但文檔完善、上手快。本文總結 Flask 應用在 SAE 的依賴管理、打包部署、目錄結構與 Makefile 自動化最佳實踐。
requirements.txt:SAE 未預裝的第三方套件,需打包上傳。requirements-dev.txt:SAE 已預裝(如 Flask、requests),本地開發用,部署時不打包。
# 本地安裝非預裝依賴
pip install -r requirements.txt
# SAE 環境安裝(部署機器上執行)
saecloud install -r requirements-dev.txt
site-packages.zip
cd site-packages/
zip -r ../site-packages.zip .
index.wsgi 載入路徑
import os, sys
root = os.path.dirname(__file__)
# 二選一,推薦 zip 版(上傳快、維護易)
sys.path.insert(0, os.path.join(root, 'site-packages'))
sys.path.insert(0, os.path.join(root, 'site-packages.zip'))
LICENSE
Makefile
README.md
requirements-dev.txt
requirements.txt
site-packages/ # 本地開發用,不提交
site/ # Web App 根目錄
index.wsgi
main.py
config.yaml
site-packages.zip # 部署依賴,提交版控
...
.gitignore
/site-packages
/site/site-packages.zip
/site/index.wsgic
.PHONY: deps package deploy
deps:
pip install -r requirements.txt
saecloud install -r requirements-dev.txt
package:
cd site-packages && zip -r ../site/site-packages.zip .
deploy: package
saecloud deploy -p myapp -v 1
sae.storage、sae.kvdb、MySQL、外部儲存。taskqueue 或 cron 非同步處理。雖然 SAE 逐漸被 Kubernetes、Serverless 取代,但其「Git 推送部署、內建服務、免運維」模式對中小專案仍有參考價值。理解其依賴隔離與打包機制,有助於理解現代雲原生構建流程(如 Docker layer caching、Buildpacks)。