區域 ID
REGION_ID
是 Google 根據您在建立應用程式時選取的地區所指派的簡寫代碼。雖然某些區域 ID 可能看起來與常用的國家/地區代碼相似,但此代碼並非對應國家/地區或省份。如果是 2020 年 2 月後建立的應用程式,App Engine 網址會包含 REGION_ID.r
。如果是在此日期之前建立的現有應用程式,網址中則可選擇加入地區 ID。
進一步瞭解區域 ID。
瞭解如何在本機執行應用程式、進行部署,然後在 App Engine 上測試。
在本機上執行
如要在部署前先測試應用程式,請使用您常用的開發工具,在本機環境中執行應用程式。
部署應用程式前
部署應用程式前:
- Google Cloud 專案的擁有者必須設定 Google Cloud 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」選單,依區域篩選。
管理建構映像檔
每次部署新版本時:
App Engine 會使用 Cloud Build 服務建立容器映像檔。
Cloud Build 會在應用程式所在的區域中建構容器映像檔,並在 App Engine 標準環境中執行。
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
服務的新版本:
部署新版本,但避免系統將流量自動轉送至新版本:
gcloud app deploy --no-promote
前往下列網址以存取新版本:
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
的要求轉送至先前設為接收流量的版本。當您要將流量傳送至新版本時,請使用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 服務和版本。