Marcos的方格子

使用 Cloud Functions 2nd Gen 進行流量拆分、漸進式部署和回滾版本

Marcos
Marcos
發佈於Marcos談科技
閱讀時間約 14 分鐘

Overview

Cloud Run 允許您指定哪些修訂版應該接收流量，並指定不同版本接收的流量比例。Revisions 也能使您能夠回滾到先前的版本、逐步增加新版本的流量比例，或在多個修訂版之間拆分流量。

前置作業

  1. 啟用 Cloud Shell

有兩種方法。可以從 console 的右上角打開終端機或是到 https://shell.cloud.google.com/ 會打開純文字的 shell 介面

  1. PROJECT 的設定和身分驗證
gcloud auth list
# 驗證身分
gcloud config list project
# 確認當下要使用的 PROJECT
gcloud config set project <Project ID>
# 更改要使用的 PROJECT
gcloud services enable cloudfunctions.googleapis.com
# 開啟 Cloud Function API

創建 Cloud Function (Traffic Splitting)

  1. 建立並進入工作資料夾
mkdir revisions-gcf-codelab && cd $_
REGION=<YOUR_REGION>
PROJECT_ID=<YOUR-PROJECT-ID>
BG_COLOR=darkseagreen # 實作更換 BG_COLOR ，代表不同版本的 Revisions

REGION=us-east1
PROJECT_ID=solution-marcos-01
BG_COLOR=darkseagreen
  1. 新增檔案 package.json

cat <<EOF >> package.json
{
    "dependencies": {
        "@google-cloud/functions-framework": "^3.0.0"
    }
}
EOF

  1. 新增檔案 index.js

cat <<EOF >> index.js
const functions = require('@google-cloud/functions-framework');

const BG_COLOR = process.env.BG_COLOR;
const K_REVISION = process.env.K_REVISION;

functions.http('helloHttp', (req, res) => {
    res.writeHead(200, { 'Content-Type': 'text/html' });
    res.end('<html><body style="background-color:' + BG_COLOR + ';"' + '><div><p>' + 'Hello from ' + K_REVISION + ' using color ' + BG_COLOR + '</p></div></body>' + '</html>');
});
EOF

  1. 部屬 Cloud Function (traffic-splitting-gcf)
gcloud functions deploy traffic-splitting-gcf \\
  --gen2 \\
  --runtime nodejs20 \\
  --entry-point helloHttp \\
  --source . \\
  --region $REGION \\
  --trigger-http \\
  --no-allow-unauthenticated \\
  --update-env-vars BG_COLOR=$BG_COLOR
raw-image


  1. 使用 curl 指令測試剛部屬的 Cloud Function，看見的結果是返回 darkseagreen
SERVICE_URL=$(gcloud run services describe traffic-splitting-gcf --platform managed --region $REGION --format 'value(status.url)')

curl -H "Authorization: bearer $(gcloud auth print-identity-token)" -X GET $SERVICE_URL
raw-image


  1. 現在部屬另外一個 revision 使用 tan作為 background color:
# update the env var
BG_COLOR=tan

# deploy the function
gcloud functions deploy traffic-splitting-gcf \\
  --gen2 \\
  --runtime nodejs20 \\
  --entry-point helloHttp \\
  --source . \\
  --region $REGION \\
  --trigger-http \\
  --no-allow-unauthenticated \\
  --update-env-vars BG_COLOR=$BG_COLOR
  1. 重新使用 curl 指令呼叫 Cloud Fuction 的 endpoint，會返回 tan
curl -H "Authorization: bearer $(gcloud auth print-identity-token)" -X GET $SERVICE_URL
raw-image


進行 50-50 各半的流量拆分

  1. 使用指令取得 revision IDs:
gcloud run revisions list --service traffic-splitting-gcf \\
  --region $REGION --format 'value(REVISION)'
raw-image


  1. 使用指令進行流量拆分，<> 內的 REVISION 要改為剛剛取得的 revision IDs:
gcloud run services update-traffic traffic-splitting-gcf \\
  --region $REGION \\
  --to-revisions <REVISION1>=50,<REVISION2>=50
raw-image


  1. 使用迴圈呼叫服務的端點 10 次，確認流量拆分成功:
for i in {1..10}; do
	echo -e $i "times\\n"
  curl -H "Authorization: bearer $(gcloud auth print-identity-token)" $SERVICE_URL
  echo -e "\\n"
  sleep 1
done
raw-image


漸進式分配流量

  1. 部屬一個新的 Cloud Function (gradual-rollouts-gcf) ，將 BG_COLOR 先設為 beige。
# update the env var
BG_COLOR=beige

# deploy the function
gcloud functions deploy gradual-rollouts-gcf \\
  --gen2 \\
  --runtime nodejs20 \\
  --entry-point helloHttp \\
  --source . \\
  --region $REGION \\
  --trigger-http \\
  --no-allow-unauthenticated \\
  --update-env-vars BG_COLOR=$BG_COLOR


  1. 先將流量 100% 切回 BG_COLOR=beige 的 REVISION
# get the revision name
BEIGE_REVISION=$(gcloud run revisions list --service gradual-rollouts-gcf \\
  --region $REGION --format 'value(REVISION)')

# now set 100% traffic to that revision
gcloud run services update-traffic gradual-rollouts-gcf --to-revisions=$BEIGE_REVISION=100 --region $REGION
raw-image


  1. 更新 BG_COLOR 為 lavender，新增一個 lavender 的 REVISION
# update color
BG_COLOR=lavender

# deploy the function that will not receive any traffic
gcloud functions deploy gradual-rollouts-gcf \\
  --gen2 \\
  --runtime nodejs20 \\
  --entry-point helloHttp \\
  --source . \\
  --region $REGION \\
  --trigger-http \\
  --no-allow-unauthenticated \\
  --update-env-vars BG_COLOR=$BG_COLOR


  1. 即使 lavender REVISION 是最新的版本，但是呼叫端點可以看到流量都還是在 beige REVISION
# get Cloud Function (gradual-rollouts-gcf)'s enpoint
SERVICE_URL2=$(gcloud run services describe gradual-rollouts-gcf --platform managed --region $REGION --format 'value(status.url)')

curl -H "Authorization: bearer $(gcloud auth print-identity-token)" -X GET $SERVICE_URL2
raw-image


  1. 取得 gradual-rollouts-gcf 的 image URL
IMAGE_URL=$(gcloud run services describe gradual-rollouts-gcf --region $REGION --format 'value(IMAGE)')
  1. 使用 BG_COLOR 為 lavender 作為 tag 標記新部屬版本的 gradual-rollouts-gcf
gcloud run deploy gradual-rollouts-gcf --image $IMAGE_URL --no-traffic --tag $BG_COLOR --region $REGION --no-allow-unauthenticated
  1. 現在可以開始對 lavender Revision，逐漸分配流量。使用指令分配 1% 流量到 tag=lavender 的版本
gcloud run services update-traffic gradual-rollouts-gcf --region $REGION --to-tags lavender=1
raw-image


  1. 使用指令分配 50% 流量到 tag=lavender 的版本
gcloud run services update-traffic gradual-rollouts-gcf --region $REGION --to-tags lavender=50
  1. 使用指令分配 100% 流量到 tag=lavender 的版本
gcloud run services update-traffic gradual-rollouts-gcf --region $REGION --to-tags lavender=100
raw-image


  1. 呼叫端點可以看到流量都是在 lavender REVISION
curl -H "Authorization: bearer $(gcloud auth print-identity-token)" -X GET $SERVICE_URL2
raw-image


回滾到之前的版本

  1. 使用指令回滾到之前的版本 beige revision
gcloud run services update-traffic gradual-rollouts-gcf --to-revisions $BEIGE_REVISION=100 --region $REGION
raw-image


  1. 呼叫端點可以看到返回 beige 的結果
curl -H "Authorization: bearer $(gcloud auth print-identity-token)" -X GET $SERVICE_URL2


如果你喜歡這篇文章歡迎幫我按愛心鼓勵一下喔!~閱讀愉快!~

參考資料

延伸閱讀

程式碼

Marcos的方格子Marcos談科技
Marcos的方格子
18會員
37內容數
歡迎來到「Marcos的方格子」！目前在「Marcos談科技」撰寫在職涯上學習到的知識，在「Marcos談書」分享我在日常的閱讀和心得，歡迎您的到來!!
留言0
查看全部
發表第一個留言支持創作者！
Marcos的方格子 的其他內容
Google Cloud Professional Network Engineer 考試/資源/心得整理
閱讀時間約 12 分鐘
如何安全地部屬 AI 應用程式在 Google Cloud : 最佳實踐
閱讀時間約 7 分鐘
大型語言模型的提詞攻擊(Prompt hacking)介紹 | 提詞攻擊遊戲介紹
閱讀時間約 10 分鐘
使用 Cloud Build 在 Cloud Run 進行持續部屬 (整合github)
閱讀時間約 29 分鐘
Google Cloud Certified Professional Cloud Developer 考試/資源/心得
閱讀時間約 6 分鐘
免信用卡？免費 Google Cloud 實作學習資源-Google Cloud Arcade
閱讀時間約 4 分鐘
你可能也想看
創作者要怎麼好好休息 + 避免工作過量？《黑貓創作報#4》午安，最近累不累？ 這篇不是虛假的關心。而是《黑貓創作報》發行以來可能最重要的一篇。 是的，我們這篇講怎麼補充能量，也就是怎麼休息。
Thumbnail
avatar
黑貓老師
2024-06-29
#創作#作者#社群
使用PROCESS macro for SPSS 進行調節式中介分析(moderated mediation)PROCESS macro for SPSS 可以用非常簡單方式學會調節中介模式。本文將介紹四種類型的變項，並解釋調節式中介的公式，還有如何操作最4.0版本的PROCESS macro for SPSS。文末也會附上所有所有Process模型圖例，提供給讀者方便分析~
Thumbnail
avatar
Dr. Rover
2023-05-15
#PROCESS#SPSS#程式
使用PROCESS macro for SPSS 進行調節模式分析PROCESS macro for SPSS 可以用非常簡單方式使用調節分析。本文將介紹三種類型的變項，還有如何操作最4.2版本的PROCESS macro for SPSS進行調節模式。文末也會附上所有所有Process模型圖例，提供給讀者方便分析~
Thumbnail
avatar
Dr. Rover
2023-04-16
#SPSS#模型#程式
使用PROCESS macro for SPSS 進行中介模式分析 PROCESS macro for SPSS 可以用非常簡單方式進中介模式。本文將介紹三種類型的變項，還有如何操作最4.0版本的PROCESS macro for SPSS。文末也會附上所有所有Process模型圖例，提供給讀者方便分析~
Thumbnail
avatar
Dr. Rover
2023-03-15
#PROCESS#SPSS#學習
使用Potato Media寫作平台一年半來的心得及收入報告Potato Media雖然和方格子及Matters同樣歸類為寫作平台，同樣強調將內容變現，前者卻與後面兩者完全不同，當然，所獲得的收入報酬也不會一樣，更清楚一點來說，連獲得收益的方式也大不相同。
Thumbnail
avatar
宋雨桐Love Queen
2023-03-11
#PotatoMedia#PotatoMedia收入#平台
使用SPSS做信度分析我們將介紹各種類型的信度和統計方法，包含Cohen Kappa 係數、組內相關係數、α係數的SPSS教學。信度的可以使用不同的評估方法來評估。信度對於確定評分標準或量表的一致性和穩定度至關重要。
Thumbnail
avatar
Dr. Rover
2023-01-31
#SPSS#信度#測驗
使用SPSS進行羅吉斯迴歸如果依變項並非連續變項時，就可以改用羅吉斯迴歸。接下來本文將介紹勝算、勝算比、計算範例、二元/順序/多項式羅吉斯迴歸分析範例和SPSS操作方法。
Thumbnail
avatar
Dr. Rover
2023-01-31
#SPSS#回歸#增加
使用SPSS進行卡方檢定（交叉表）通常我們對於類別變項就直接看敘述統計大小，但如果我們想要用檢定確定兩者差距是達到統計顯著，就要用卡方檢定（Chi-square test）是一種統計學方法，獨立性考驗用於檢驗兩個類別變項各組別之間是否有顯著關聯。本文將介紹卡方檢定並介紹上機操作和事後比較方法。
Thumbnail
avatar
Dr. Rover
2023-01-30
#SPSS#統計#校正
使用Mplus進行結構方程模型(SEM):匯入資料、建立模型、中介、調節分析本篇介紹Mplus的「結構方程模型(Structural Equation Modelling, SEM)」之語法內容，並透過例題向大家示範如何分析撰寫SEM的語法。本文為新手教學，輸入方式可能不是最有效率，但是比較簡單且不太會犯錯
Thumbnail
avatar
Dr. Rover
2023-01-20
#Mplus#模型#輸入
使用SPSS進行相依樣本t檢定當樣本有所關聯時，就不能使用獨立樣本t檢定，而是需要使用相依樣本t檢定，本文檢定介紹使用時機，並教導如何使用SPSS進行相依樣本t檢定
Thumbnail
avatar
Dr. Rover
2022-11-25
#統計#SPSS#相依樣本t檢定
使用
avatar
YUKI
2022-11-04