部署 Python 專案

Zeabur 支援眾多類型的 Python 專案，包含但不限於這些：

如果你的原始碼底下有 app.py, main.py 等 entrypoint，Zeabur 也會自動啟動。

NPM 支援

如果你的專案根目錄有 package.json，Zeabur 會自動幫您安裝 Node.js 和 NPM；如果你的 package.json 有 build script，Zeabur 會自動幫你執行 npm install && npm run build 編譯產物。

如果需要更改編譯的命令（如改執行 npm run build:dist），請參閱〈自訂編譯與啟動命令〉。

Zeabur 預設會辨識 main.py、app.py、manage.py、server.py、app/__init__.py 這些 Entrypoint，但如果你的 Entrypoint 不在上面列出的清單中，可以設定環境變數

ZBPACK_PYTHON_ENTRY=your-entrypoint.py

或者是在 zbpack.json 中加入以下設定：

{
    "python": {
        "entry": "your-entrypoint.py"
    }
}

這樣 Zeabur 就會以 your-entrypoint.py 作為 Python 的執行檔案。

如果你想部署 WSGI/ASGI 應用程式（比如 Django、Flask、FastAPI），且 entrypoint 是在 __init__.py 裡面，則必須寫出完整路徑（包含 __init__.py 在內）：

# server/__init__.py
 
app = Flask(__name__)

ZBPACK_PYTHON_ENTRY=server/__init__.py

如果你的 entrypoint 在 __main__.py，亦需要寫出完整路徑：

# server/__main__.py
 
print("Hello!")

ZBPACK_PYTHON_ENTRY=server/__main__.py

Zeabur 允許你使用環境變數或設定檔自訂 Python 的編譯和啟動命令。

「編譯命令」適合用在需要下載或編譯自訂產物（如 CSS、JavaScript 等等），或者是配置設定檔的情境。舉例來說，你想往 /etc 資料夾寫入設定檔，你可以設定環境變數

ZBPACK_BUILD_COMMAND=echo 'your-configuration' > /etc/somewhere

或者是在 zbpack.json 中加入以下設定：

{
    "build_command": "echo 'your-configuration' > /etc/somewhere"
}

你亦可以在這裡執行 npm 的命令。注意 Zeabur 只會在 專案根目錄 有 package.json 的情況下安裝 Node.js 和 NPM，如果你的專案沒有 package.json，則不會有 npm 命令可用：

{
    "build_command": "npm install && npm run build:dist"
}

「啟動命令」則適合用在啟動 Python 應用程式時執行的情境，如在原有的命令基礎上加上 python3 migrate.py 來建立資料庫的 tables。舉例來說，你可以設定環境變數

ZBPACK_START_COMMAND="python3 migrate.py && _startup"

或者是在 zbpack.json 中加入以下設定：

{
    "start_command": "python3 migrate.py && _startup"
}

其中 _startup 是 Zeabur 原本的啟動命令（可以在 zbpack 查閱 (opens in a new tab)）。如果你有自訂 start_command，_startup 必須在你的啟動命令中執行，否則不會啟動 Python 應用程式。

build_command 和 start_command 均會使用 POSIX 相容的 shell 執行，所以你可以使用 && 串接多個命令，或者使用 ; 分隔多個命令。

如果你的依賴清單（requirements.txt、Pipfile、pyproject.toml⋯⋯）有宣告 playwright，Zeabur 會自動幫您準備好執行 Playwright 必要的環境。

如果你的依賴清單（requirements.txt、Pipfile、pyproject.toml⋯⋯）有宣告 seleniumbase 或 selenium，Zeabur 會自動幫您準備好執行 Selenium 必要的環境。

Zeabur 支援將 Python 部署成 serverless 專案。不過目前需要 opt-in。請參考啟用 Serverless 頁面啟用 serverless 支援。

Zeabur 預設使用 Python 3.10 作為執行環境，不過 Zeabur 會根據你專案設定的 Python 版本選擇執行環境，你也可以根據需要自訂執行環境。

「在專案指定 Python 版本」是比較通用的做法，在每個環境都能使用。

[requires]
python_version = "3.8"   # 在這裡指定 Python 版本

[tool.poetry.dependencies]
python = "^3.8"  # 在這裡指定 Python 版本

[project]
requires-python = ">= 3.8"  # 在這裡指定 Python 版本

rye pin 3.8  # 在這裡指定 Python 版本

如果你使用的是傳統的 requirements.txt，或你需要在 Zeabur 覆蓋專案指定的 Python 版本，你可以在 zbpack.json 中指定 Python 版本。

{
    "python": {
        "version": "3.8"
    }
}

或者是使用 ZBPACK_PYTHON_VERSION 環境變數指定 Python 版本：

ZBPACK_PYTHON_VERSION=3.8

如果你有安裝 streamlit 依賴，且檔名是 app.py、main.py 和 streamlit_app.py，Zeabur 預設會以 Streamlit 模式啟動你的應用程式。

不過假如檔名不是上面這三個，你可以在 zbpack.json 中指定檔名。比如你的 Streamlit 應用程式的檔名是 myapp.py：

{
    "streamlit": {
        "entry": "myapp.py"
    }
}

這樣 Zeabur 就會以 Streamlit 模式啟動你的 myapp.py。你也可以使用環境變數 ZBPACK_STREAMLIT_ENTRY 指定檔名：

ZBPACK_STREAMLIT_ENTRY=myapp.py