Cloud Run 函式會在環境中執行,該環境包含作業系統版本、附加套件、語言支援,以及支援和叫用函式的 Python Functions Framework 程式庫。這個環境會以語言版本識別,稱為執行階段 ID。
函式準備
您可以直接從 Google Cloud 控制台準備函式,也可以在本機撰寫函式並上傳。如要準備本機電腦以進行 Python 開發作業,請參閱「設定 Python 開發環境」。
支援的 Python 執行階段和基礎映像檔
| 執行階段 | 執行階段 ID | 堆疊 | 執行階段基礎映像檔 |
|---|---|---|---|
| Python 3.14 (預先發布版) |
python314 |
|
|
| Python 3.13 | python313 |
|
|
| Python 3.12 | python312 |
|
|
| Python 3.11 | python311 |
|
|
| Python 3.10 | python310 |
|
|
| Python 3.9 | python39 | google-18-full | google-18-full/python39 |
| Python 3.8 | python38 | google-18-full | google-18-full/python38 |
| Python 3.7 | python37 | google-18-full | google-18-full/python37 |
選取執行階段
在部署期間,您可以針對函式選取其中一個支援的 Python 執行階段。
您可以使用 Google Cloud 控制台或 gcloud CLI 選取執行階段版本。按一下分頁標籤,瞭解如何使用自選工具:
gcloud
部署函式時,請使用 --base-image 標記指定函式的 Python 基本映像檔。例如:
gcloud run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image python313
取代:
將 FUNCTION 改為您要部署的函式名稱。您可以完全省略這個參數,但這樣系統會提示您輸入名稱。
FUNCTION_ENTRYPOINT,並在原始碼中輸入函式的進入點。這是 Cloud Run 在函式執行時執行的程式碼。這個旗標的值必須是來源程式碼中存在的函式名稱或完整類別名稱。
如需使用 gcloud CLI 部署函式的詳細操作說明,請參閱「在 Cloud Run 中部署函式」。
控制台
在 Google Cloud 控制台中建立或更新 Cloud Run 函式時,您可以選取執行階段版本。如需部署函式的詳細操作說明,請參閱「在 Cloud Run 中部署函式」。
如要在建立函式時,透過 Google Cloud 控制台選取執行階段,請按照下列步驟操作:
前往 Google Cloud 控制台的 Cloud Run 頁面:
按一下「編寫函式」。
在「Runtime」(執行階段) 清單中,選取 Python 執行階段版本。
按一下「建立」,然後等待 Cloud Run 使用預留位置修訂版本建立服務。
主控台會將您重新導向至「來源」分頁,您可以在這裡查看函式的原始碼。按一下「儲存並重新部署」。
如需函式部署後更新執行階段版本的詳細操作說明,請參閱「重新部署新的原始碼」。
原始碼結構
如要讓 Cloud Run functions 找到函式的定義,原始碼必須遵循特定結構。詳情請參閱「編寫 Cloud Run functions」。
指定依附元件
您可以透過幾種方式,為 Python 中的 Cloud Run 函式指定依附元件:使用套件管理員的 requirements.txt 檔案、將 pyproject.toml 檔案設定為標準專案定義檔案,或與函式一起封裝本機依附元件。詳情請參閱「在 Python 中指定依附元件」。
Cloud Run functions 不支援使用 Pipfile/Pipfile.lock 指定依附元件,因此專案不應包含這些檔案。
環境變數
Python 執行階段會自動為函式設定特定環境變數,供函式視需要使用。詳情請參閱「設定環境變數」。