測試及部署應用程式

區域 ID

REGION_ID 是 Google 根據您在建立應用程式時選取的地區所指派的簡寫代碼。雖然某些區域 ID 可能看起來與常用的國家/地區代碼相似,但此代碼並非對應國家/地區或省份。如果是 2020 年 2 月後建立的應用程式,App Engine 網址會包含 REGION_ID.r。如果是在此日期之前建立的現有應用程式,網址中則可選擇加入地區 ID。

進一步瞭解區域 ID

瞭解如何在本機執行應用程式、進行部署,然後在 App Engine 上測試。

在本機上執行

如要在部署前先測試應用程式,請使用您常用的開發工具,在本機環境中執行應用程式。

部署應用程式前

部署應用程式前:

部署應用程式

使用 gcloud app deploy 指令,將應用程式部署到 App Engine。在部署期間,Cloud Build 服務會建構應用程式的容器映像檔,以在標準環境中執行。每個版本都會在與 Google Cloud 專案相同的地區執行。詳情請參閱「管理建構的映像檔」。

如要透過程式部署應用程式,請使用 Admin API

部署服務

您可以部署應用程式服務的版本及各版本的設定檔,藉此將應用程式部署至 App Engine。

如要部署應用程式服務的某個版本,請從服務的 app.yaml 檔案所在的目錄執行下列指令:

gcloud app deploy

使用該指令時如未指定任何檔案,僅會部署目前目錄中的 app.yaml 檔案。根據預設,deploy 指令會針對您部署的版本產生唯一 ID,並將該版本部署到您設定 Google Cloud CLI 要使用的Google Cloud 專案,再將所有流量轉送至新版本。

您可指定特定檔案,或是加入其他參數來改變指令的預設行為:

  • 如要部署服務的其他設定檔,您必須個別指定及部署每個檔案。例如:
    gcloud app deploy cron.yaml
    gcloud app deploy dispatch.yaml
    gcloud app deploy index.yaml
  • 如要指定自訂版本 ID,請使用 --version 標記。
  • 如要避免系統將流量自動轉送至新版本,請使用 --no-promote 標記。
  • 如要部署到特定的 Google Cloud 專案,請使用 --project 標記。

舉例來說,如要將 app.yaml 檔案定義的服務部署至特定的Google Cloud 專案,請為該服務指派自訂版本 ID,還要避免將流量轉送至新版本:

gcloud app deploy --project PROJECT_ID --version VERSION_ID --no-promote

如要進一步瞭解這個指令,請參閱 gcloud app deploy 參考資料

如果您在部署新版本時採用現有版本的名稱,App Engine 會立即將流量遷移至新版本。當 App Engine 將要求載入新版本時,延遲時間會遽增。新版本會覆寫舊版本,您無法將流量遷移至舊版本。系統會立即關閉舊版本的所有執行個體,詳情請參閱「遷移流量」。

部署多項服務

您可以使用相同的部署指令來部署或更新組成應用程式的多項服務。

事前準備:

  • 您必須先將應用程式的某個版本部署到 default 服務,才能建立及部署後續服務。
  • 您必須在每項服務各自對應的 app.yaml 設定檔中指定服務的 ID。如要指定服務 ID,請在每個設定檔中加入 service 元素定義。根據預設,從設定檔排除此元素定義會將版本部署至 default 服務。

如要部署多項服務,請個別部署每項服務的 app.yaml 檔案。您可以透過單一 gcloud app deploy 指令指定多個檔案:

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

查看建構作業記錄

Cloud Build 會串流建構和部署記錄,您可以在 Google Cloud 控制台的 Cloud Build「Build history」部分查看這些記錄。如要查看應用程式所在區域的建構作業,請使用「Region」選單,依區域篩選。

管理建構映像檔

每次部署新版本時:

  1. App Engine 會使用 Cloud Build 服務建立容器映像檔。

  2. Cloud Build 會在應用程式所在的區域中建構容器映像檔,並在 App Engine 標準環境中執行。

  3. App Engine 會將建構的容器映像檔儲存在 Artifact Registry 中。您可以下載這些映像檔來加以保存或在其他地方執行。

部署完成後,App Engine 就不再需要容器映像檔。容器映像檔不會自動刪除。如要避免讓儲存空間配額達到上限,您可以放心刪除任何不需要的圖片。不過,如果您日後可能需要圖片或想保留圖片的副本,請在刪除圖片前匯出副本。如要進一步瞭解如何管理 Artifact Registry 中的映像檔,請參閱「管理映像檔」。

略過檔案

您可以使用 .gcloudignore 檔案,指定部署服務時不要上傳至 App Engine 的檔案和目錄。如要略過不必隨著部署作業一起上傳的版本構件和其他檔案,這個方法十分實用。

查看您的應用程式

將應用程式部署至 App Engine 之後,您可以執行下列指令來啟動瀏覽器,並在 https://PROJECT_ID.REGION_ID.r.appspot.com 查看應用程式:

gcloud app browse

在轉移流量之前在 App Engine 上測試

您可以先在 App Engine 上測試新版本,然後再設定該版本以接收流量。例如,您可採取下列做法來測試 default 服務的新版本:

  1. 部署新版本,但避免系統將流量自動轉送至新版本:

    gcloud app deploy --no-promote

  2. 前往下列網址以存取新版本:

    https://VERSION_ID-dot-default-dot-PROJECT_ID.REGION_ID.r.appspot.com

    您現在可以在 App Engine 執行階段環境中測試新版本。您可以查看應用程式記錄來進行偵錯。詳情請參閱「寫入應用程式記錄」。

    App Engine 會將傳送至 https://PROJECT_ID.REGION_ID.r.appspot.com 的要求轉送至先前設為接收流量的版本。

  3. 當您要將流量傳送至新版本時,請使用Google Cloud 控制台遷移流量:

    管理版本

    選取您剛剛部署的版本,然後按一下 [Migrate traffic] (遷移流量)

您可以將網址中的 default 換成服務名稱,即可使用相同程序來測試其他服務的新版本:

https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com

如要進一步瞭解如何指定特定服務和版本,請參閱「要求的轉送方式」。

使用建構環境變數

您可以為支援Buildpack 的執行階段設定建構環境變數。

建構環境變數是鍵/值組合,可用來指定要用來部署應用程式的建構包。舉例來說,您可能需要指定編譯器選項。

事前準備:

  • 鍵的開頭必須是大寫 ASCII 字母,且可包含大寫 ASCII 字母、數字和底線。
  • 請避免建立任何含有 GOOGLE_* 鍵前置字元的變數。
  • 下列鍵已預留給 Google 使用:
    • GOOGLE_RUNTIME
    • GOOGLE_RUNTIME_VERSION
    • GOOGLE_ENTRYPOINT
    • GOOGLE_DEVMODE
  • 您可以使用buildpack 支援的任何鍵。

如要搭配 Buildpack 使用環境變數,請在 app.yaml 檔案中指定 build_env_variables 欄位。

進一步瞭解 Buildpack。

使用 Cloud Trace

Cloud Trace 可協助您瞭解要求在應用程式中傳播的情形。您可以查看單項要求的詳細延遲資訊,或是瀏覽整個應用程式的匯總延遲資料。

如要在 Cloud Trace 中查看追蹤記錄詳細資料,請按照尋找及探索追蹤記錄中的步驟操作。在追蹤記錄探索工具中,您可以使用篩選器篩選特定 App Engine 服務和版本。