例: Step Functions でのエイリアスとバージョンのデプロイ

現在のステートマシンリビジョンからバージョンを公開します。

AWS CLI で publish-state-machine-version コマンドを使用して、myStateMachine: というステートマシンの現在のリビジョンからバージョンを公開します。

aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:region:account-id:stateMachine:myStateMachine

レスポンスでは、公開したバージョンの stateMachineVersionArn が返されます。例えば、arn:aws:states:region:account-id:stateMachine:myStateMachine:1。

ステートマシンバージョンを指すエイリアスを作成します。

create-state-machine-alias コマンドを使用して、myStateMachine のバージョン 1 を指す PROD というエイリアスを作成します。

aws stepfunctions create-state-machine-alias --name PROD --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:region:account-id:stateMachine:myStateMachine:1\",\"weight\":100}]"

エイリアスによって開始された実行で、正しい公開バージョンが使用されていることを確認します。

start-execution コマンドにエイリアス PROD の ARN を指定して、myStateMachine の新しい実行を開始します。

aws stepfunctions start-execution 
  --state-machine-arn arn:aws:states:region:account-id:stateMachineAlias:myStateMachine:PROD
  --input "{}"

StartExecution リクエストでステートマシン ARN を指定すると、実行を開始するためにエイリアスで指定されたバージョンではなく、ステートマシンの最新の revision が使用されます。

ステートマシン定義を更新し、新しいバージョンを公開します。

myStateMachine を更新して新しいバージョンを公開します。これを行うには、update-state-machine コマンドのオプションの publish パラメータを使用します。

aws stepfunctions update-state-machine
    --state-machine-arn arn:aws:states:region:account-id:stateMachine:myStateMachine
    --definition $UPDATED_STATE_MACHINE_DEFINITION
    --publish

レスポンスでは、新しいバージョンの stateMachineVersionArn が返されます。例えば、arn:aws:states:region:account-id:stateMachine:myStateMachine:2。

両方のバージョンを指すようエイリアスを更新し、エイリアスのルーティング設定を指定します。

update-state-machine-alias コマンドを使用して、エイリアス PROD のルーティング設定を更新します。実行トラフィックの 80% がバージョン 1 に送られ、残りの 20% がバージョン 2 に送られるようエイリアスを設定します。

aws stepfunctions update-state-machine-alias --state-machine-alias-arn arn:aws:states:region:account-id:stateMachineAlias:myStateMachine:PROD --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:region:account-id:stateMachine:myStateMachine:1\",\"weight\":80}, {\"stateMachineVersionArn\":\"arn:aws:states:region:account-id:stateMachine:myStateMachine:2\",\"weight\":20}]"

バージョン 1 をバージョン 2 に置き換えます。

新しいステートマシンバージョンが正しく動作することを確認したら、新しいステートマシンバージョンをデプロイできます。そのためには、エイリアスを再度更新して、実行トラフィックの 100% を新しいバージョンに割り当てます。

update-state-machine-alias コマンドを使用して、バージョン 2 のエイリアス PROD のルーティング設定を 100% に設定します。

aws stepfunctions update-state-machine-alias --state-machine-alias-arn arn:aws:states:region:account-id:stateMachineAlias:myStateMachine:PROD --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:region:account-id:stateMachine:myStateMachine:2\",\"weight\":100}]"