測試及部署應用程式

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

在本機上執行

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

部署應用程式

Cloud Build 服務會自動將部署內容建構為容器映像檔，並將映像檔部署至 App Engine 彈性環境。容器中會包含您對執行階段映像檔所進行的任何本機修訂。

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

事前準備

部署應用程式之前：

• Google Cloud 專案的擁有者必須設定 Google Cloud App Engine 專案。

• 請確認您的使用者帳戶含有必要權限。

部署服務

您可以透過部署應用程式各項服務的版本及設定檔，將應用程式部署至 App Engine。

• 您可以個別指定及部署每個檔案，藉此部署服務的其他設定檔，例如：

  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 參考資料。

您可以為 gcloud CLI 設定屬性，並建立及管理 SDK 設定，這樣就不需要在每次進行部署時指定 --project 等標記。

略過檔案

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

如要進一步瞭解 .gcloudignore 檔案的語法，請參閱 gcloud 參考資料。

手動建構用於部署的容器

如要在 Google Cloud外建構容器映像檔，請按照下列步驟操作：

1. 將映像檔上傳至 Artifact Registry 存放區。詳情請參閱「推送及拉取映像檔」。
2. 使用 gcloud app deploy 指令將應用程式部署至 App Engine。

舉例來說，如果您在本機環境中使用 Docker 建構容器映像檔，則可將這些映像檔推送至 Artifact Registry，並在指令的 --image-url 標記中指定映像檔的網址：

gcloud app deploy --image-url LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE

取代：

• LOCATION 與圖片儲存位置的存放區。

• PROJECT-ID 替換為您的 Google Cloud 專案 ID。

• REPOSITORY 與儲存映像檔的存放區名稱。

• IMAGE 改為您的容器映像檔名稱。

使用自動化持續部署管道

您可以使用 Cloud Build 自動在持續部署管道中進行部署。詳情請參閱 Cloud Build 說明文件中的「部署至 App Engine」和「建立及管理建構觸發條件」相關章節。

Docker 基本映像檔

如果您想建構自訂執行階段應用程式，請參閱「建立 Docker 檔案」。

查看您的應用程式

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

gcloud app browse

在 App Engine 上測試

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

1. 將 promote 參數設為 false，部署新版 並加入 --no-promote 標記：

   gcloud app deploy --no-promote

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

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

   您現在可以在 App Engine 執行階段環境中測試新版本。您可以在Google Cloud 控制台的 記錄檔探索工具中查看應用程式的記錄，藉此進行偵錯。詳情請參閱「寫入應用程式記錄」。

   系統仍會將傳送至 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 可協助您瞭解要求在應用程式中傳播的情形。您可以查看單項要求的詳細延遲資訊，或是瀏覽整個應用程式的匯總延遲資料。

您可以查看追蹤記錄詳細資料。在追蹤記錄探索器中，您可以依特定 App Engine 服務和版本進行篩選。

疑難排解

以下是部署應用程式時，您可能會看到的常見錯誤訊息：

PERMISSION_DENIED: Operation not allowed

The "appengine.applications.create" permission is required.

如果 Google Cloud 專案缺少必要的 App Engine 應用程式，gcloud app deploy 指令嘗試執行 gcloud app create 指令時可能會失敗。只有具備「擁有者」角色的帳戶才具有建立 App Engine 應用程式的必要權限。

502 Bad Gateway

如果 app.yaml 設定錯誤， Google Cloud 專案可能無法啟動。查看應用程式記錄，瞭解錯誤訊息的詳細資訊。

[13] An internal error occurred while creating a Cloud Storage bucket.

App Engine 會代表您在建立應用程式的同一個區域中，建立預設 Cloud Storage 多地區值區。這個值區用於儲存應用程式內容。當無法建立這個值區時，系統會傳回錯誤，例如在下列情況下：

• 專案中沒有 App Engine 彈性環境服務代理人，或是沒有 App Engine flexible environment Service Agent 角色。您可以授予服務帳戶正確的 IAM 權限，將服務帳戶重新加入專案。請參閱「還原已刪除的服務代理程式」。

• 專案中沒有預設的 App Engine 服務帳戶。如果 App Engine 服務帳戶在刪除後的 30 天內遭到移除，您可以還原該帳戶。

• 您的專案屬於強制執行 constraints/gcp.resourceLocations 政策的機構，而該機構不允許在建立 App Engine 的區域中建立資源。您必須覆寫專案的強制 constraints/gcp.resourceLocations 政策，並允許在建立 App Engine 應用程式的地區使用多地區位置。

舉例來說，如果您的 App Engine 應用程式是在 europe-west 地區建立，即使該地區會對應至 europe-west1 位置，您仍必須修改限制，允許 in:eu-locations 中的資源，其中包含所有 EU 區域。這是必要的，因為 App Engine 建立的儲存格是跨區域的。如果 App Engine 應用程式是在 US 區域建立，您必須允許 in:us-locations；如果應用程式是在 ASIA 區域建立，則必須允許 in:asia-locations。

[13] An internal error occurred.

如果您使用共用虛擬私有雲設定的網路設定部署服務，就可能發生此錯誤。建議您嘗試下列做法：

1. 確認 app.yaml 設定有效。
2. 請確認您的 App Engine 彈性環境符合共用 VPC 設定的所有要求。請參閱「在共用虛擬私人雲端網路上使用 App Engine 彈性環境」。
3. 請務必在專案中設定服務帳戶。如果沒有，請務必還原帳戶。共用虛擬私人雲端主專案中的子網路區域必須與建立 App Engine 環境的位置相符。

如果問題仍未解決，請使用 Google Cloud SDK 重新部署服務。請務必新增 --verbosity=debug 旗標。請與Google Cloud 支援團隊聯絡，並提供指令的輸出內容。

IP space of {USER_SUBNETWORK_NAME} is exhausted and needs to be expanded.

如果部署失敗並顯示這則錯誤訊息，表示為 App Engine 服務設定的網路沒有可用來分配給服務新執行個體的位址。如要解決這個問題，請擴大為 App Engine 彈性環境服務設定的子網路的 VPC 範圍。