本頁面由 Cloud Translation API 翻譯而成。

測試及部署應用程式

區域 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

注意： 您可以在 Google Cloud 主控台中找到版本 ID，或是在使用 --version flag 部署時自行指定。進行部署時，Google Cloud CLI 也會輸出版本 ID。
您現在可以在 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 的執行階段設定建構環境變數。

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