기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
상태 시스템 별칭
별칭은 같은 상태 시스템의 버전을 최대 2개까지 가리킵니다. 상태 시스템 별칭을 여러 개 만들 수 있습니다. 별칭마다 고유한 Amazon 리소스 이름(ARN)이 있습니다. 별칭 ARN은 상태 시스템 ARN과 별칭 이름의 조합이며 콜론(:)으로 구분됩니다. 다음 예제에서는 상태 시스템 별칭 ARN의 형식을 보여줍니다.
arn:partition
:states:region
:account-id
:stateMachine:myStateMachine
:aliasName
별칭을 사용하여 두 상태 시스템 버전 중 하나 간에 트래픽을 라우팅할 수 있습니다. 단일 버전을 가리키는 별칭을 만들 수도 있습니다. 별칭은 상태 시스템 버전만 가리킬 수 있습니다. 별칭을 사용하여 다른 별칭을 가리킬 수는 없습니다. 상태 시스템의 다른 버전을 가리키도록 별칭을 업데이트할 수도 있습니다.
상태 시스템 별칭 만들기(콘솔)
Step Functions 콘솔을 사용하거나 CreateStateMachineAliasAPI 작업을 호출하여 각 상태 머신에 대해 최대 100개의 별칭을 생성할 수 있습니다. 이 소프트 한도 증가를 요청하려면 AWS Management Console의 지원 센터 페이지를 사용합니다. 콘솔에서 또는 API 작업을 호출하여 사용하지 않는 별칭을 삭제합니다. DeleteStateMachineAlias
상태 시스템 별칭 만들기
-
Step Functions 콘솔
을 열고 기존 상태 시스템을 선택합니다. -
상태 시스템 세부 정보 페이지에서 별칭 탭을 선택합니다.
-
새 별칭 생성을 선택합니다.
-
별칭 생성(Create alias) 페이지에서 다음을 수행합니다.
-
별칭 이름을 입력합니다.
-
(선택 사항) 경보에 대한 설명(Description)을 입력합니다.
-
-
별칭에 대한 라우팅을 구성하려면 별칭 라우팅 구성을 참조하세요.
-
별칭 생성을 선택합니다.
Step Functions API 작업으로 별칭 관리
Step Functions는 상태 시스템 별칭을 생성 및 관리하거나 별칭에 대한 정보를 가져오는 데 사용할 수 있는 다음 API 작업을 제공합니다.
-
CreateStateMachineAlias— 상태 머신의 별칭을 생성합니다.
-
DescribeStateMachineAlias— 상태 시스템 별칭에 대한 세부 정보를 반환합니다.
-
ListStateMachineAliases— 지정된 상태 시스템 ARN의 별칭을 나열합니다.
-
UpdateStateMachineAlias— 또는 를 수정하여 기존 상태 시스템 별칭의 구성을 업데이트합니다.
description
routingConfiguration
-
DeleteStateMachineAlias— 상태 시스템 버전을 삭제합니다.
를
사용하여 이름을 지정한 myStateMachine
상태 머신의 버전 1을 가리키는 별칭을 만들려면 AWS Command Line Interface 명령을 사용합니다. PROD
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는 라우팅 구성에 지정된 버전 중에서 실행할 상태 시스템 버전을 임의로 선택합니다. 이 선택은 별칭 라우팅 구성에서 각 버전에 할당하는 트래픽 비율을 기반으로 합니다.
별칭에 대한 라우팅 구성 구성하기
-
별칭 만들기 페이지의 라우팅 구성에서 다음을 수행합니다.
-
버전에서 별칭이 가리키는 첫 번째 상태 시스템 버전을 선택합니다.
-
두 버전 간 트래픽 분할 확인란을 선택합니다.
작은 정보
단일 버전을 가리키려면 두 버전 간 트래픽 분할 확인란을 선택 취소하세요.
-
버전에서 별칭이 가리켜야 하는 두 번째 버전을 선택합니다.
-
트래픽 비율 필드에서 각 버전으로 라우팅할 트래픽 비율을 지정합니다. 예를 들어 실행 트래픽의 60%를 첫 번째 버전으로, 40%를 두 번째 버전으로 라우팅하려면
60
및40
을 입력합니다.합친 트래픽 비율은 100%이어야 합니다.
-
별칭을 사용하여 상태 시스템 실행(콘솔)
콘솔에서 별칭을 사용하거나 별칭의 ARN으로 StartExecutionAPI 작업을 호출하여 상태 시스템 실행을 시작할 수 있습니다. 그러면 Step Functions에서 별칭으로 지정된 버전을 실행합니다. 상태 시스템 실행을 시작할 때 버전이나 별칭을 지정하지 않으면 Step Functions는 기본적으로 최신 버전을 사용합니다.
별칭을 사용하여 상태 시스템 실행 시작하기
-
Step Functions 콘솔
을 열고 별칭을 만든 기존 상태 시스템을 선택합니다. 별칭을 만드는 방법은 상태 시스템 별칭 만들기(콘솔)를 참조하세요. -
상태 시스템 세부 정보 페이지에서 별칭 탭을 선택합니다.
-
별칭 섹션에서 다음을 수행합니다.
-
실행을 시작할 별칭을 선택합니다.
-
실행 시작을 선택합니다.
-
-
(선택 사항) 실행 시작 대화 상자에 실행 이름을 입력합니다.
-
필요한 경우 실행 입력을 입력한 다음 실행 시작을 선택합니다.