기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Step Functions 워크플로의 스테이트 머신 별칭

별칭은 같은 상태 시스템의 버전을 최대 2개까지 가리킵니다. 상태 시스템 별칭을 여러 개 만들 수 있습니다. 각 별칭에는 고유한 Amazon 리소스 이름 (ARN) 이 있습니다. ARN별칭은 스테이트 ARN 머신과 별칭 이름을 조합한 것으로, 콜론 (:) 으로 구분됩니다. 다음 예제는 스테이트 머신 별칭의 형식을 보여줍니다. ARN

arn:partition:states:region:account-id:stateMachine:myStateMachine:aliasName

별칭을 사용하여 두 상태 시스템 버전 중 하나 간에 트래픽을 라우팅할 수 있습니다. 단일 버전을 가리키는 별칭을 만들 수도 있습니다. 별칭은 상태 시스템 버전만 가리킬 수 있습니다. 별칭을 사용하여 다른 별칭을 가리킬 수는 없습니다. 상태 시스템의 다른 버전을 가리키도록 별칭을 업데이트할 수도 있습니다.

상태 시스템 별칭 만들기(콘솔)

Step Functions 콘솔을 사용하거나 작업을 호출하여 각 상태 머신에 대해 최대 100개의 별칭을 생성할 수 있습니다. CreateStateMachineAliasAPI 이 소프트 한도 증가를 요청하려면 다음 Support Center 페이지를 사용하십시오. AWS Management Console. 콘솔에서 또는 작업을 호출하여 사용하지 않는 별칭을 삭제합니다. DeleteStateMachineAliasAPI

Step API Functions 작업을 통한 별칭 관리

Step Functions는 상태 시스템 별칭을 생성 및 관리하거나 별칭에 대한 정보를 가져오는 데 사용할 수 있는 다음과 같은 API 작업을 제공합니다.

를 사용하여 이름을 PROD 지정한 상태 시스템의 버전 1을 가리키는 별칭을 만들려면 myStateMachine AWS Command Line Interface, create-state-machine-alias 명령을 사용하십시오.

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

별칭 라우팅 구성

별칭을 사용하여 상태 시스템 두 버전 간에 실행 트래픽을 라우팅할 수 있습니다. 새 버전의 상태 시스템을 시작하려는 경우를 예로 들어 보겠습니다. 별칭에 대한 라우팅을 구성하여 새 버전 배포와 관련된 위험을 줄일 수 있습니다. 라우팅을 구성하면 대부분의 트래픽을 테스트를 거친 상태 시스템의 이전 버전으로 보낼 수 있습니다. 그러면 새 버전을 롤포워드해도 안전한지 확인할 때까지 새 버전에 더 적은 비율을 보낼 수 있습니다.

라우팅 구성을 정의하려면 별칭에서 가리키는 상태 시스템 버전 두 개 모두 게시해야 합니다. 별칭에서 실행을 시작하면 Step Functions는 라우팅 구성에 지정된 버전 중에서 실행할 상태 시스템 버전을 임의로 선택합니다. 이 선택은 별칭 라우팅 구성에서 각 버전에 할당하는 트래픽 비율을 기반으로 합니다.

별칭을 사용하여 상태 시스템 실행(콘솔)

콘솔에서 별칭을 사용하거나 별칭을 사용하여 StartExecutionAPI작업을 호출하여 상태 시스템 실행을 시작할 수 있습니다. ARN 그러면 Step Functions에서 별칭으로 지정된 버전을 실행합니다. 상태 시스템 실행을 시작할 때 버전이나 별칭을 지정하지 않으면 Step Functions는 기본적으로 최신 버전을 사용합니다.