Python 3 執行階段環境

Python 3.7 執行階段是軟體堆疊,負責安裝網路服務的程式碼和其依附元件,並執行服務。

適用於 App Engine 標準環境的 Python 3.7 執行階段在 app.yaml 檔案中會宣告為:

runtime: python37

Python 3 版本

Python 3.7 執行階段環境採用穩定且最新的 Python 3.7 版。App Engine 會在部署時自動更新到最新的次要修訂版本,但是不會自動更新主要版本。

舉例來說,您的應用程式可能先採用 Python 3.7.0 版進行部署,並在之後自動更新成 Python 3.7.1,但是並不會自動更新至 Python 3.8.0。

目前,Python 3.7 是唯一可以在 App Engine 標準環境中使用的 Python 3 執行階段。

依附元件

在部署期間,App Engine 會使用 Python 套件管理員 pip 安裝依附元件,這些依附元件在專案根目錄的 requirements.txt 中繼資料檔案中定義。您不需要上傳依附元件,因為 App Engine 會執行全新安裝。

目前,系統並不支援使用 Pipfile/Pipfile.lock 標準指定依附元件,且您的專案不允許存在這些檔案。

啟動應用程式

執行階段會使用 app.yaml 檔案中選用 entrypoint 欄位的內容啟動應用程式。例如:

runtime: python37
entrypoint: gunicorn -b :$PORT main:app

為了讓應用程式接收 HTTP 要求,entrypoint 應啟動一個網路伺服器,來監聽由 PORT 環境變數指定的通訊埠。您可以選擇是否使用 entrypoint;如果您的應用程式符合下列條件,App Engine 會將 gunicorn 當成網路伺服器使用,並自動將套件新增至您的 requirements.txt 檔案。

  • 應用程式的根目錄中包含 main.py 檔案,該檔案擁有與 WSGI 相容且名為 app 的物件。

  • app.yaml 不包含 entrypoint 欄位。

  • 您的應用程式不包含 PipfilePipfile.lock 檔案。

您可以將其他網路架構與 App Engine 搭配使用,例如 uwsgiTornado。下列範例顯示如何將 uwsgi 與 App Engine 搭配使用:

runtime: python37
entrypoint: uwsgi --http-socket :8080 --wsgi-file main.py --callable app --master --processes 1 --threads 2
uwsgi==2.0.17.1
flask==1.0.2

有 HTTP 要求時,您的應用程式會使用這個預先設定的網路伺服器來執行。

Entrypoint 最佳做法

除非您要指定 entrypoint,否則請勿在 requirements.txt 檔案中包含 gunicorn

如要獲得最佳效能,應使用輕量的 entrypoint,因為當您為應用程式建立新的執行個體時,每一次都會執行該項目。

您可以利用 entrypoint 欄位調整應用程式的效能。舉例來說,假設您使用 gunicorn 做為網路伺服器,則可在 entrypoint 欄位中使用 --workers 標記設定提供應用程式的工作站數量。您選擇的工作站數量應與 App Engine 部署作業的執行個體大小相符:

執行個體類別 工作站
F1 (預設) 1
F2 2
F4 4
F4_1G 8
B1 (預設) 1
B2 2
B4 4
B4_1G 8
B8 8

這項指引可當成選取工作站數量的起點。根據應用程式的效能特性,您可能需要使用不同數量的工作站。以下範例顯示使用兩個 gunicorn 工作站提供應用程式的 App Engine 部署作業:

runtime: python37
entrypoint: gunicorn -b :8080 -w 2 main:app

環境變數

下列為執行階段設定的環境變數:

環境變數 說明
GAE_APPLICATION App Engine 應用程式的 ID。
GAE_DEPLOYMENT_ID 目前部署的 ID。
GAE_ENV App Engine 環境。設定為 standard
GAE_INSTANCE 服務目前正在執行的執行個體 ID。
GAE_MEMORY_MB 應用程式程序可用的記憶體量,以 MB 為單位。
GAE_RUNTIME app.yaml 檔案中指定的執行階段。
GAE_SERVICE app.yaml 檔案中指定的服務名稱。如果未指定服務名稱,則會設為 default
GAE_VERSION 服務目前的版本標籤。
GOOGLE_CLOUD_PROJECT 與應用程式相關聯的 GCP 專案 ID。
NODE_ENV 在部署服務時設定為 production
PORT 接受 HTTP 要求的通訊埠。

您可以app.yaml 檔案中定義其他環境變數,但無法覆寫 NODE_ENV 以外的上述值。

HTTPS 和轉送 Proxy

App Engine 會在負載平衡器上終止 HTTPS 連線,並將要求轉送至您的應用程式。部分應用程式需要判斷原始要求 IP 和通訊協定。您可以在標準 X-Forwarded-For 標頭中找到使用者的 IP 位址。需要這項資訊的應用程式應將其網路架構設定為信任 Proxy。

檔案系統

執行階段包含完整的檔案系統。檔案系統為唯讀狀態,但位置 /tmp 除外。這個位置是在 App Engine 執行個體的 RAM 中儲存資料的虛擬磁碟。

中繼資料伺服器

應用程式的每個執行個體都可以使用 App Engine 中繼資料伺服器來查詢與執行個體和專案相關的資訊。

您可以透過以下端點存取中繼資料伺服器:

  • http://metadata
  • http://metadata.google.internal

下表列出可讓您針對特定中繼資料發出 HTTP 要求的端點:

中繼資料端點 說明
/computeMetadata/v1/project/numeric-project-id 指派給專案的專案編號。
/computeMetadata/v1/project/project-id 指派給專案的專案 ID。
/computeMetadata/v1/instance/zone 執行個體執行的區域。
/computeMetadata/v1/instance/service-accounts/default/aliases
/computeMetadata/v1/instance/service-accounts/default/email 指派給專案的預設服務帳戶電子郵件。
/computeMetadata/v1/instance/service-accounts/default/ 列出專案的所有預設服務帳戶。
/computeMetadata/v1/instance/service-accounts/default/scopes 列出預設服務帳戶的所有支援範圍。
/computeMetadata/v1/instance/service-accounts/default/token 傳回可用來向其他 Google Cloud API 驗證應用程式的驗證憑證。

例如,如要擷取專案 ID,請將要求傳送至 http://metadata.google.internal/computeMetadata/v1/project/project-id

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Python 3 適用的 App Engine 標準環境