別名和版本部署範例 - AWS Step Functions

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

別名和版本部署範例

下列 Canary 部署技術範例顯示如何使用AWS Command Line Interface. 在此範例中,您建立的別名會將 20% 的執行流量路由至新版本。然後,它將剩餘的 80% 路由到早期版本。若要部署新的狀態機器版本並使用別名轉移執行流量,請完成以下步驟:

  1. 從目前的狀態機器修訂發佈版本。

    使用中的publish-state-machine-versionAWS CLI指令從名為的狀態機器的目前版本發佈版本 myStateMachine:

    aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine

    回應會stateMachineVersionArn傳回您發佈的版本。例如:arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:1

  2. 建立指向狀態機版本的別名。

    使用指create-state-machine-alias令建立指向以下版本 1 PROD 的名稱的別名myStateMachine

    aws stepfunctions create-state-machine-alias --name PROD --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:1\",\"weight\":100}]"
  3. 驗證別名啟動的執行使用正確的發佈版本。

    透過PRODstart-execution命令中myStateMachine提供別名的 ARN 來啟動的新執行:

    aws stepfunctions start-execution --state-machine-arn arn:aws:states:us-east-1:123456789012:stateMachineAlias:myStateMachine:PROD --input "{}"

    如果您在StartExecution請求中提供狀態機 ARN,它會使用最新revision的狀態機器,而不是別名中指定的版本來開始執行。

  4. 更新狀態機定義並發佈新版本。

    更新myStateMachine並發布其新版本。要做到這一點,使用update-state-machine命令的可選publish參數:

    aws stepfunctions update-state-machine --state-machine-arn arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine --definition $UPDATED_STATE_MACHINE_DEFINITION --publish

    回應會stateMachineVersionArn傳回新版本的。例如:arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:2

  5. 更新別名以指向兩個版本,並設置別名的路由配置。

    使用update-state-machine-alias指令更新別名的路由組態PROD。設定別名,讓 80% 的執行流量進入第 1 版,剩餘的 20% 會移至第 2 版:

    aws stepfunctions update-state-machine-alias --state-machine-alias-arn arn:aws:states:us-east-1:123456789012:stateMachineAlias:myStateMachine:PROD --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:1\",\"weight\":80}, {\"stateMachineVersionArn\":\"arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:2\",\"weight\":20}]"
  6. 將版本 1 取代為版本 2。

    確認新的狀態機器版本正常運作之後,您可以部署新的狀態機器版本。若要這麼做,請再次更新別名,將 100% 的執行流量指派給新版本。

    使用update-state-machine-alias指令將版本 2 的別PROD名路由配置設定為 100%:

    aws stepfunctions update-state-machine-alias --state-machine-alias-arn arn:aws:states:us-east-1:123456789012:stateMachineAlias:myStateMachine:PROD --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:2\",\"weight\":100}]"
提示

若要復原第 2 版的部署,請編輯別名的路由組態,將 100% 的流量轉移到新部署的版本。

aws stepfunctions update-state-machine-alias --state-machine-alias-arn arn:aws:states:us-east-1:123456789012:stateMachineAlias:myStateMachine:PROD --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:1\",\"weight\":100}]"

您可以使用版本和別名來執行其他類型的部署。例如,您可以執行新版本的狀態機器的滾動部署。若要這麼做,請逐漸增加指向新版本之別名路由組態中的加權百分比。

您也可以使用版本和別名來執行藍/綠部署。為此,請創建一個名為的別名,green該別名運行狀態機的當前版本 1。然後,建立另一個名blue為執行新版本的別名,例如2。若要測試新版本,請將執行流量傳送至blue別名。當您確定新版本正常運作時,請更新green別名以指向新版本。