區域 ID
REGION_ID
是 Google 根據您在建立應用程式時選取的地區所指派的縮寫代碼。此代碼不對應至國家/地區或省份,即使部分區域 ID 可能與常用的國家/地區和省份代碼相似。如果是 2020 年 2 月後建立的應用程式,App Engine 網址會包含 REGION_ID.r
。如果是這段時間前建立的現有應用程式,網址可選擇是否包含地區 ID。
進一步瞭解區域 ID。
本指南的這個章節說明如何寫入、測試及部署您在上一節「部署您的網路服務」中部署範例網路服務的更新。
事前準備
如果您尚未完成此「建構應用程式」指南中先前各節的相關操作,請先執行操作:
- 建立含有 App Engine 應用程式的專案。 Google Cloud
- 撰寫簡單的 Node.js 網路服務。
- 在 App Engine 上部署網路服務。
更新範例網路服務
下列各節會使用表單和使用者提交表單時,系統回應的處理常式來更新範例網路服務。
為使用者輸入建立表單
如要讓使用者提交資料至伺服器,請使用 HTML 表單。
在
my-nodejs-service
資料夾中,建立名為views
的資料夾,用來儲存 HTML 檔案。在
views
資料夾中,建立名為form.html
的檔案,並加入下列程式碼:
這個簡易表單可讓使用者輸入要傳送給伺服器的名稱和訊息。它會透過 HTTP POST
要求將資料傳送至 /submit
,如 <form>
元素上的 method
和 action
屬性所指定。
此時,您應該會有如下所示的檔案結構:
my-nodejs-service/
views/
form.html
app.yaml
package.json
server.js
顯示表單
將下面這行新增到
server.js
檔案頂端以匯入path
模組:const path = require(`path`);
新增下列 Express 處理常式,在使用者瀏覽至
/submit
時顯示表單:
為提交的資料建立處理常式
使用者將訊息提交至伺服器時,系統會將含有資料的 POST
要求傳送至 /submit
。如要從要求主體讀取資料,請使用 Express urlencoded
中介軟體,並建立新的要求處理常式。
將應用程式設為使用 Express
urlencoded
中介軟體:在
server.js
檔案中新增POST
處理常式,以便讀取資料:
此範例處理常式會將使用者的名稱和訊息記錄至主控台,但您也可以在資料上執行操作,或將資料儲存在資料庫中。
在本機測試表單
部署變更之前,請從本機測試新表單。
啟動 Node.js 伺服器:
npm start
前往
http://localhost:8080/submit
查看表單。提交包含表單的訊息。您應該會看見您的名稱和訊息出現在終端機視窗中。
部署變更
部署更新時,會建立預設服務的新版本,且流量會自動轉送至最新版本。部署做法:
在
my-nodejs-service
資料夾中執行下列指令:gcloud app deploy
這與您在「部署網路服務」中學到的指令相同。
確認 Google Cloud 控制台列出新版本:
您應該會看見兩個版本,分別對應到先前與目前的部署。
部署之後,可前往 https://PROJECT_ID.REGION_ID.r.appspot.com
/submit
存取新表單。歡迎提交一則或兩則訊息!
如果您不再需要先前的版本,可以從 Google Cloud 控制台的「versions」(版本) 頁面將其刪除。
後續步驟
現在,應用程式有了可讓使用者提交資料的表單,接下來請學習如何在 Google Cloud 控制台查看應用程式的記錄。