部署 Python 應用程式

您可以部署應用程式,以上傳到 App Engine 上執行。部署應用程式時,您必須在 App Engine 中建立應用程式的版本及對應的服務。您可以部署完整的應用程式 (包括所有原始碼和設定檔),也可以部署及更新個別的版本或設定檔

如要以程式化的方式來部署應用程式,請使用 Admin API

事前準備

在您部署應用程式之前,請先完成下列事項:

如要使用 gcloud 工具部署應用程式,您必須下載、安裝並初始化 Google Cloud SDK:

下載 SDK

如果您已經安裝了 gcloud 工具,且想設定為使用某個 GCP 專案 ID,而非工具初始化時使用的專案 ID,請參閱管理 Cloud SDK 設定說明。

使用 Proxy

如果您是以使用 HTTP 或 HTTPS Proxy 的系統執行部署指令,則必須設定工具,讓工具能夠透過 Proxy 進行通訊。

gcloud

請執行下列指令來設定 gcloud 工具:

gcloud config set proxy/type [PROXY_TYPE]
gcloud config set proxy/address [PROXY_ADDRESS]
gcloud config set proxy/port [PROXY_PORT]

您也可以設定 Proxy 的 usernamepassword,詳情請參閱 gcloud config 一文。

appcfg

設定與您的 Proxy 對應的環境變數:

Mac/Linux
export HTTP_PROXY="http://cache.example.com:3128"
export HTTPS_PROXY="http://cache.example.com:3128"
Windows
set HTTP_PROXY=http://cache.example.com:3128
set HTTPS_PROXY=http://cache.example.com:3128

部署應用程式

如要將應用程式部署到 App Engine,請在設定檔 (例如 app.yaml) 所在的應用程式根目錄中執行 gcloud app deploy 指令。

gcloud

gcloud app deploy [YOUR_DEPLOYMENTS]

其中,[YOUR_DEPLOYMENTS] 是一或多個設定檔的路徑和名稱。您可以使用單個空格來分隔各個指定的設定檔。根據預設,如果未指定任何設定檔,則會部署 app.yaml

選用標記:

  • 加上 --version 標記可指定自訂版本 ID;如未加入,則由系統產生。
  • 如要部署應用程式但不要將所有流量自動轉送至該版本,請加入 --no-promote 標記。
  • 加入 --project 標記可指定替代 GCP 專案 ID,而不使用您在初始化 gcloud 工具時設為預設值的專案 ID。

範例:

gcloud app deploy
gcloud app deploy app.yaml dos.yaml index.yaml
gcloud app deploy --version [YOUR_VERSION_ID] --no-promote --project [YOUR_PROJECT_ID]

根據預設,您部署的每個版本都會自動設定為接收 100% 的流量。如需瞭解設定選項,請參閱 gcloud app deploy 參考資料中的 --promote 標記。

提示:以指令列執行 gcloud help,可取得完整的引數和標記清單。

appcfg

安裝原始的 Python 專用 App Engine SDK 之後,您可以執行以下指令:

appcfg.py -A [YOUR_PROJECT_ID] -V [YOUR_VERSION_ID] update [YOUR_APP_DIR]

根據預設,您部署至服務的初始版本均會自動設為接收 100% 的流量。然而部署至相同服務的後續版本,則必須手動部署,否則會無法接收到流量。

選擇不重複的版本 ID

如果是手動調調度資源的執行個體,版本的 ID 應以字母開頭,以和數字執行個體 ID 有所區別。如此可確保要求會轉送至正確的目的地,避免與 123.my-service.appspot.com 之類的網址模式混淆不清,這類模式可以有兩種解讀方式:

  • 如果 123 版本存在,要求會轉送至 my-service 服務的 123 版本。
  • 如果 123 版本不存在,要求會改為轉送至執行 my-service 服務各個版本的執行個體 ID 123

對於設定成自動調整資源配置或基本資源配置的執行個體,您可以任意為版本命名,因為系統不支援將這些執行個體指定為目標

部署多個服務應用程式

當您的應用程式分成多項服務時,您可以個別部署和更新指定的服務,也可以同時在所有服務上進行。更新個別的設定檔,或是更新對應版本中的原始碼,都屬於部署更新的範圍。

舉例來說,您可以在 App Engine 中部署並建立兩個版本,而這兩個版本分別在各自的服務中執行。第一個版本做為前端服務使用,另一個版本則做為應用程式的後端。接下來您可以部署個別版本的設定檔,僅更新服務的設定。您也可以選擇部署服務的新版本,同時更新前端或後端的原始碼,或是兩者一起更新。

多重服務的需求

您可以使用相同的部署指令來部署和更新應用程式的多項服務,以滿足以下需求:

  • 必須先將應用程式的某個版本部署到 default 服務,然後才能建立和部署後續服務。

  • 必須在對應版本的 app.yaml 設定檔中指定服務的 ID。如要指定服務 ID,則需在每個設定檔中加入 service: [YOUR_SERVICE_ID] 元素定義。根據預設,如果從設定檔中排除這個元素定義,系統會將版本部署至 default 服務。

  • 必須在部署指令中指定所有對應的 app.yaml 設定檔,才能同時部署多項服務。

部署多重服務的方式

請從設定檔所在的應用程式根目錄執行部署指令,並指定各服務 app.yaml 檔案的相對路徑和檔案名稱:

gcloud

gcloud app deploy [DEPLOYMENTS]

appcfg

appcfg.py update [DEPLOYMENTS]

其中 [DEPLOYMENTS] 是一或多個設定檔的路徑和名稱。您可以使用單個空格來分隔每個指定的設定檔。

範例

gcloud

gcloud app deploy main/app.yaml service1/app.yaml service2/app.yaml

appcfg

appcfg.py update main/app.yaml service1/app.yaml service2/app.yaml

成功部署各項服務後,會從指令列收到驗證訊息。

更新索引

如要建立或更新應用程式使用的索引,請將 index.yaml 設定檔上傳到 Cloud Datastore。上傳設定檔後,系統就會建立尚未存在的索引。

Cloud Datastore 可能需要一些時間才能建立所有索引,因此這些索引無法馬上提供給 App Engine 使用。如果您的應用程式已設定為接收流量,當查詢所需的索引仍在建構中時,便會發生例外狀況。

為了避免例外狀況發生,必須讓系統有充裕的時間來建構所有索引,例如:

  • 先將 index.yaml 設定檔上傳到 Cloud Datastore,然後再部署版本:

    1. index.yaml 檔案上傳到 Cloud Datastore:

      appcfg
      appcfg.py -A [YOUR_PROJECT_ID] -V [YOUR_VERSION_ID] update_indexes [YOUR_APP_DIR]

    2. 使用 GCP 主控台監控所有索引的狀態:

      前往 Datastore 頁面

    3. 所有索引建構完成後,將新版本部署至 App Engine

  • 先建構索引,再將流量遷移或拆分至您的版本:

    1. 部署新版本,但不將流量轉送至該版本:
      gcloud
      必須同時指定 app.yamlindex.yaml 檔案,並加入 --no-promote 標記,這樣流量才不會轉送至該版本:
      gcloud app deploy app.yaml index.yaml --no-promote
      appcfg
      appcfg.py -A [YOUR_PROJECT_ID] -V [YOUR_VERSION_ID] update [YOUR_APP_DIR]
    2. 使用 GCP 主控台監控所有索引的狀態:

      前往 Datastore 頁面

    3. 所有索引建構完成後,再使用 GCP 主控台將流量遷移或拆分至該版本:

      前往版本頁面

如需關於索引的更多資訊,請參閱設定 Datastore 索引

疑難排解

以下是您可能會看到的常見錯誤訊息:

PERMISSION_DENIED: Operation not allowed
The "appengine.applications.create" permission is required.
如果 GCP 專案缺少必要的 App Engine 應用程式,在嘗試執行 gcloud app create 指令時,gcloud app deploy 指令可能會失敗。只有具備「擁有者」角色的帳戶才擁有建立 App Engine 應用程式的必要權限。
Command not found

如果您在安裝 SDK 時並未建立 appcfg.pydev_appserver.py 工具的符號連結,則可能需要指定完整目錄路徑才能執行工具,例如:[PATH_TO_APP_ENGINE_SDK]/appcfg.py[PATH_TO_CLOUD_SDK]/bin/dev_appserver.py

注意:如要使用 appcfg.py,您必須下載及安裝原始的 Python 專用 App Engine SDK

Import Error

如果您安裝了 Google Cloud SDK 及原始 App Engine SDK,則 PATH 的項目可能與另一個項發生衝突,造成匯入錯誤。如果您在執行 Cloud SDK 指令時收到錯誤訊息,請嘗試明確使用原始的 App Engine SDK。您可以將原始 App Engine SDK 的項目移到 PATH 中較前面的位置,讓這些指令優先執行。此外,您也可以指定完整的目錄路徑來執行指令:[PATH_TO_APP_ENGINE_SDK]/dev_appserver.py
提示:可在 Linux 或 Mac 中執行 which dev_appserver.py,以確定 PATH 中優先的 SDK 版本。

[400] The first service (module) you upload to a new application must be the 'default' service (module)

在部署及建立應用程式的多項服務之前,必須先部署及建立 default 服務。如要進一步瞭解如何將版本部署至 default 服務,請參閱部署多個服務應用程式一節。

Too Many Versions (403)

App Engine 對應用程式設有部署版本數量限制。免費應用程式和已部署的應用程式的限制數量各不相同。您可以使用 GCP 主控台刪除較舊的版本,然後上傳最新的程式碼。

後續步驟

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

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

這個網頁
App Engine standard environment for Python 2