本指南將說明如何:
- 佈建預覽伺服器即可啟用容器的預覽功能。
- 佈建標記伺服器來處理即時流量。
- 增加或減少執行 Google 代碼管理工具容器的伺服器數量。
- 佈建伺服器後,請持續更新標記伺服器版本。
必備條件
- 您需要 GCP 帳戶。如果沒有帳戶,請建立新的 GCP 帳戶。
- 您需要一個 GCP 帳單帳戶。如果您沒有帳戶,請建立 GCP 帳單帳戶 (需要「帳單帳戶建立者」角色)。
- 您必須具備「專案建立者」與「帳單帳戶使用者角色」角色。進一步瞭解如何新增角色。
佈建預覽和標記伺服器
您可以在 Google 代碼管理工具中自動佈建 Cloud Run 服務,或是在 Google Cloud 中手動佈建。
編輯服務設定
如要變更服務設定:
- 開啟 Cloud Run。
- 選取您要調整的服務。
- 按一下「Edit & Deploy New Revision」。
- 進行變更,然後按一下「部署」。
Cloud Run 費用
在這項 Cloud Run 設定中,每部伺服器的費用約為每月 $45 美元 (美元)。每個伺服器都是 Cloud Run 執行個體,具有 1 個 vCPU 和 0.5 GB 記憶體,並使用一律分配的 CPU 定價模式。
建議您至少執行 2 個執行個體,以降低伺服器服務中斷時資料遺失的風險。不過,您可以選擇減少 (或更多) 伺服器。 我們預期自動調度資源 2-10 個伺服器每秒會處理 35-350 個要求,不過效能會因標記數量及其用途而有所不同。
Cloud Run 會隨負載動態調整資源配置。max-instances
設定是最糟的情況,是指您需要為資源支付多少費用。除非必要,否則 Cloud Run 不會佈建這麼多執行個體。
Cloud Run 計算機
選用:從 App Engine 遷移
如果您先前曾建立過 App Engine 部署,且已確認該部署作業無法再收到任何流量,請停用 App Engine 應用程式,以免產生非預期的費用。
選用:多區域部署
如果您的網站遍布全球,或者您想在服務中建構備援功能,請將標記伺服器部署至多個地區。
事前準備:
- 建立負載平衡器
- 記下您選擇的 BACKEND_NAME。
如要在部署作業中新增更多區域,請按照下列步驟操作:
- 將 REGION 替換為部署預覽伺服器的區域。如果您按照指令列選項佈建預覽和標記伺服器,可能已填寫完畢。
- 將 CONTAINER_CONFIG 替換為代碼管理工具的容器設定字串。如果您遵循指令列選項佈建預覽和標記伺服器,系統可能已經填妥這些資訊。
- 將 NEW_REGION 替換為您想部署標記伺服器的新區域。
- 將 BACKEND_NAME 替換成您在佈建負載平衡器時選擇的名稱。
- 選用:如要新增其他區域,請替換 NEW_REGION 變數,然後重新執行程式碼片段。
gcloud run deploy "server-side-tagging" \
--region NEW_REGION \
--image gcr.io/cloud-tagging-10302018/gtm-cloud-image:stable \
--platform managed \
--ingress all \
--min-instances 2 \
--max-instances 10 \
--timeout 60 \
--allow-unauthenticated \
--no-cpu-throttling \
--update-env-vars PREVIEW_SERVER_URL="$(
gcloud run services describe server-side-tagging-preview \--region "REGION" \
--format="value(status.url)")",CONTAINER_CONFIG="CONTAINER_CONFIG" && \
gcloud compute network-endpoint-groups create server-side-tagging-neg \
--region=NEW_REGION \
--network-endpoint-type=SERVERLESS \
--cloud-run-service="server-side-tagging" && \
gcloud compute backend-services add-backend --global "BACKEND_NAME" \
--network-endpoint-group-region=NEW_REGION \
--network-endpoint-group=server-side-tagging-neg
選用:停用記錄功能
要求記錄
根據預設,系統會記錄每個要求的相關資訊 (例如要求路徑、查詢參數等)。如果標記伺服器每個月會處理大量要求 (例如超過 100 萬個要求),這些記錄訊息可能會產生大量的記錄費用。如要降低或降低記錄費用,建議您停用要求記錄。
如何停用要求記錄:
- 在 Google Cloud Platform 中開啟「記錄檔路由器」。請確認您所在專案與容器 ID 相符:
- 在「Type」(類型):Cloud Logging 值區,名稱:_Default 行,選取溢位選單,然後按一下 [Edit Sink] (編輯接收器)。
- 在「接收器目的地」下方,選取記錄檔值區 [_Default]。
在「選擇要納入接收器的記錄檔」下方,新增一行。請在現有的納入篩選器中輸入下列規則:
NOT LOG_ID("run.googleapis.com/requests")
如要一併停用負載平衡器的記錄功能,請新增一行,然後在現有的納入篩選器中輸入下列規則:
NOT LOG_ID("requests")
更新接收器以套用變更。現在,要求會從記錄中排除。
控制台記錄功能
容器中的標記伺服器、用戶端或標記可以將訊息記錄到主控台,可能會產生記錄費用。如要降低或免除記錄費用,您可以停用不必要的主控台記錄訊息。
找出不需要的主控台記錄:
- 在 GCP 中開啟記錄檔探索工具。
找出任何來自標記的不必要的記錄訊息。例如:
標記可能會傳送下列記錄:
const logToConsole = require('logToConsole'); logToConsole('Custom message: ' + data.param1); logToConsole('An important message to keep around!'); data.gtmOnSuccess()
請在
textPayload
欄位中尋找對應的記錄訊息:
如何停用主控台記錄訊息:
- 在 Google Cloud Platform 中開啟「記錄檔路由器」。請確認您所在專案與容器 ID 相符:
- 在「Type」(類型):Cloud Logging 值區,名稱:_Default 行,選取溢位選單,然後按一下 [Edit Sink] (編輯接收器)。
- 在「接收器目的地」下方,選取記錄檔值區 [_Default]。
在「選擇要納入接收器的記錄檔」下方,新增一行。請在現有的納入篩選器中輸入下列規則:
NOT textPayload:"Custom message:"
針對主控台記錄,請將 Custom message: 文字替換為您要停用的主控台記錄中的子字串。如需更精細的篩選器,請使用記錄查詢語言。
更新接收器以套用變更。應從記錄中排除相符的
logToConsole
訊息。
2. 將部署作業對應至自訂網域
如要設定自訂網域,請使用全域外部應用程式負載平衡器。
3. 在 Google 代碼管理工具中加入伺服器網址
現在您已擁有伺服器,則必須確定 Google 代碼管理工具知道伺服器應使用您的伺服器。
開啟 Google 代碼管理工具。
按一下您要指向標記伺服器的伺服器容器。
在「Admin」分頁 >「Container Settings」開啟您的伺服器容器設定。
按一下「新增網址」,然後貼上伺服器網址。
儲存並返回工作區。
4. 驗證
標記伺服器設定完成後,請確定可以正常運作。 在代碼管理工具工作區中,按一下「預覽」按鈕。如果系統能載入預覽頁面,表示所有設定皆正確無誤。
預覽多個網址
如果您已將多個網域對應至單一標記伺服器,請務必將每個網址加到容器設定中。
如果您提供多個網址,所有路徑 (網域名稱後方的字串) 必須相符。
工作 | 無法運作 |
---|---|
網址 1:example.com/abc 網址 2: example2.com/abc |
網址 1:example.com/abc 網址 2: example2.com/def |
如果您新增多個網址,「Preview」按鈕旁會顯示一個圖示,讓您選取要預覽的網址。
更新標記伺服器版本
新的標記伺服器更新包含安全漏洞修正項目和新功能。建議您至少在代碼管理工具收到更新通知時,至少針對每個主要版本 (例如從 1.x.x 升級到 2.x.x) 更新標記伺服器。
如要更新標記伺服器,請使用先前採用的設定部署新的修訂版本。
- 開啟 Cloud Run。
- 選取要更新的服務。
- 按一下「Edit & Deploy New Revision」。
- 確認「Container image URL」(容器映像檔網址) 已設為
gcr.io/cloud-tagging-10302018/gtm-cloud-image:stable
,然後按一下「Deploy」(部署)。
如要確認更新是否成功,請按照下列步驟操作:
- 在伺服器容器中,按一下「Preview」按鈕啟動新的偵錯工作階段,並在另一個分頁中傳送要求。
- 在「Summary」(摘要) 中選取「Console」(控制台) 分頁標籤,確認沒有任何訊息要求您更新標記伺服器。
代碼管理工具可能會在伺服器成功更新最多一天後,要求您更新標記伺服器。不過,預覽頁面會顯示關於標記伺服器版本的最新資訊。