상태 시스템 별칭

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

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

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

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

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

상태 시스템 별칭 만들기

1. Step Functions 콘솔을 열고 기존 상태 시스템을 선택합니다.

2. 상태 시스템 세부 정보 페이지에서 별칭 탭을 선택합니다.

3. 새 별칭 생성을 선택합니다.

4. 별칭 생성(Create alias) 페이지에서 다음을 수행합니다.

   1. 별칭 이름을 입력합니다.

   2. (선택 사항) 경보에 대한 설명(Description)을 입력합니다.

5. 별칭에 대한 라우팅을 구성하려면 별칭 라우팅 구성을 참조하세요.

6. 별칭 생성을 선택합니다.

Step Functions API 작업으로 별칭 관리

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

• CreateStateMachineAlias— 상태 머신의 별칭을 생성합니다.

• DescribeStateMachineAlias— 상태 시스템 별칭에 대한 세부 정보를 반환합니다.

• ListStateMachineAliases— 지정된 상태 시스템 ARN의 별칭을 나열합니다.

• UpdateStateMachineAlias— 또는 를 수정하여 기존 상태 시스템 별칭의 구성을 업데이트합니다. description routingConfiguration

• DeleteStateMachineAlias— 상태 시스템 버전을 삭제합니다.

를 myStateMachine 사용하여 이름을 지정한 PROD 상태 머신의 버전 1을 가리키는 별칭을 만들려면 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는 라우팅 구성에 지정된 버전 중에서 실행할 상태 시스템 버전을 임의로 선택합니다. 이 선택은 별칭 라우팅 구성에서 각 버전에 할당하는 트래픽 비율을 기반으로 합니다.

별칭에 대한 라우팅 구성 구성하기

• 별칭 만들기 페이지의 라우팅 구성에서 다음을 수행합니다.

  1. 버전에서 별칭이 가리키는 첫 번째 상태 시스템 버전을 선택합니다.

  2. 두 버전 간 트래픽 분할 확인란을 선택합니다.

     작은 정보

     단일 버전을 가리키려면 두 버전 간 트래픽 분할 확인란을 선택 취소하세요.

  3. 버전에서 별칭이 가리켜야 하는 두 번째 버전을 선택합니다.

  4. 트래픽 비율 필드에서 각 버전으로 라우팅할 트래픽 비율을 지정합니다. 예를 들어 실행 트래픽의 60%를 첫 번째 버전으로, 40%를 두 번째 버전으로 라우팅하려면 60 및 40을 입력합니다.

     합친 트래픽 비율은 100%이어야 합니다.

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

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

별칭을 사용하여 상태 시스템 실행 시작하기

1. Step Functions 콘솔을 열고 별칭을 만든 기존 상태 시스템을 선택합니다. 별칭을 만드는 방법은 상태 시스템 별칭 만들기(콘솔)를 참조하세요.

2. 상태 시스템 세부 정보 페이지에서 별칭 탭을 선택합니다.

3. 별칭 섹션에서 다음을 수행합니다.

   1. 실행을 시작할 별칭을 선택합니다.

   2. 실행 시작을 선택합니다.

4. (선택 사항) 실행 시작 대화 상자에 실행 이름을 입력합니다.

5. 필요한 경우 실행 입력을 입력한 다음 실행 시작을 선택합니다.