기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Step Functions 워크플로의 상태 머신 별칭
*별칭*은 같은 상태 머신의 버전을 최대 2개까지 가리킵니다. 상태 머신 별칭을 여러 개 만들 수 있습니다. 별칭마다 고유한 Amazon 리소스 이름(ARN)이 있습니다. 별칭 ARN은 상태 머신 ARN과 별칭 이름의 조합이며 콜론(:)으로 구분됩니다. 다음 예제에서는 상태 머신 별칭 ARN의 형식을 보여줍니다.
```
arn:partition:states:region:account-id:stateMachine:myStateMachine:aliasName
```
별칭을 사용하여 두 상태 머신 버전 중 하나 간에 [트래픽을 라우팅](#alias-routing-config)할 수 있습니다. 단일 버전을 가리키는 별칭을 만들 수도 있습니다. 별칭은 상태 머신 버전만 가리킬 수 있습니다. 별칭을 사용하여 다른 별칭을 가리킬 수는 없습니다. 상태 머신의 다른 버전을 가리키도록 별칭을 업데이트할 수도 있습니다.
![\[요청의 80%를 v1로 보내고 20%를 v2로 보내는 별칭을 보여주는 다이어그램입니다.\]](http://docs.aws.amazon.com/ko_kr/step-functions/latest/dg/images/aliases-concept.png)
**Topics**
+ [상태 머신 별칭 만들기(콘솔)](#procedure-create-aliases)
+ [API를 사용하여 별칭 관리](#manage-aliases-with-api)
+ [별칭 라우팅 구성](#alias-routing-config)
+ [별칭을 사용하여 상태 머신 실행(콘솔)](#procedure-run-exec-with-alias)
## 상태 머신 별칭 만들기(콘솔)
Step Functions 콘솔을 사용하거나 [CreateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachineAlias.html) API 작업을 간접적으로 호출하여 상태 머신마다 별칭을 최대 100개까지 만들 수 있습니다. 이 소프트 한도 증가를 요청하려면 [AWS Management Console](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)의 **지원 센터** 페이지를 사용합니다. 콘솔에서 또는 [DeleteStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineAlias.html) API 작업을 간접적으로 호출하여 사용하지 않는 별칭을 삭제합니다.
**상태 머신 별칭 만들기**
1. [Step Functions 콘솔](https://console.aws.amazon.com/states/home?region=us-east-1#/)을 열고 기존 상태 머신을 선택합니다.
1. **상태 머신 세부 정보** 페이지에서 **별칭** 탭을 선택합니다.
1. **새 별칭 생성**을 선택합니다.
1. **별칭 생성(Create alias)** 페이지에서 다음을 수행합니다.
1. **별칭 이름**을 입력합니다.
1. (선택 사항) 경보에 대한 **설명(Description)**을 입력합니다.
1. 별칭에 대한 라우팅을 구성하려면 [별칭 라우팅 구성](#alias-routing-config)을 참조하세요.
1. **별칭 생성**을 선택합니다.
## Step Functions API 작업으로 별칭 관리
Step Functions는 상태 머신 별칭을 생성 및 관리하거나 별칭에 대한 정보를 가져오는 데 사용할 수 있는 다음 API 작업을 제공합니다.
+ [CreateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachineAlias.html) - 상태 머신 별칭을 만듭니다.
+ [DescribeStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineAlias.html) - 상태 머신 별칭에 대한 세부 정보를 반환합니다.
+ [ListStateMachineAliases](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineAliases.html) - 지정된 상태 머신 ARN의 별칭을 나열합니다.
+ [UpdateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachineAlias.html) - `description` 또는 `routingConfiguration`을 수정하여 기존 상태 머신 별칭 구성을 업데이트합니다.
+ [DeleteStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineAlias.html) - 상태 머신 별칭을 삭제합니다.
를 `myStateMachine` 사용하여 라는 상태 시스템의 버전 1을 가리키`PROD`는 라는 별칭을 생성하려면 `create-state-machine-alias` 명령을 AWS Command Line Interface사용합니다.
```
aws stepfunctions create-state-machine-alias --name PROD --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:region:account-id:stateMachine:myStateMachine:1\",\"weight\":100}]"
```
## 별칭 라우팅 구성
별칭을 사용하여 상태 머신 두 버전 간에 실행 트래픽을 라우팅할 수 있습니다. 새 버전의 상태 머신을 시작하려는 경우를 예로 들어 보겠습니다. 별칭에 대한 라우팅을 구성하여 새 버전 배포와 관련된 위험을 줄일 수 있습니다. 라우팅을 구성하면 대부분의 트래픽을 테스트를 거친 상태 머신의 이전 버전으로 보낼 수 있습니다. 그러면 새 버전을 롤포워드해도 안전한지 확인할 때까지 새 버전에 더 적은 비율을 보낼 수 있습니다.
라우팅 구성을 정의하려면 별칭에서 가리키는 상태 머신 버전 두 개 모두 게시해야 합니다. 별칭에서 실행을 시작하면 Step Functions는 라우팅 구성에 지정된 버전 중에서 실행할 상태 머신 버전을 임의로 선택합니다. 이 선택은 별칭 라우팅 구성에서 각 버전에 할당하는 트래픽 비율을 기반으로 합니다.
**별칭에 대한 라우팅 구성 구성하기**
+ **별칭 만들기** 페이지의 **라우팅 구성**에서 다음을 수행합니다.
1. **버전**에서 별칭이 가리키는 첫 번째 상태 머신 버전을 선택합니다.
1. **두 버전 간 트래픽 분할** 확인란을 선택합니다.
**작은 정보**
단일 버전을 가리키려면 **두 버전 간 트래픽 분할** 확인란을 선택 취소하세요.
1. **버전**에서 별칭이 가리켜야 하는 두 번째 버전을 선택합니다.
1. **트래픽 비율** 필드에서 각 버전으로 라우팅할 트래픽 비율을 지정합니다. 예를 들어 실행 트래픽의 60%를 첫 번째 버전으로, 40%를 두 번째 버전으로 라우팅하려면 **60** 및 **40**을 입력합니다.
합친 트래픽 비율은 100%이어야 합니다.
## 별칭을 사용하여 상태 머신 실행(콘솔)
콘솔에서 별칭을 사용하거나 별칭 ARN으로 [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) API 작업을 간접적으로 호출하여 상태 머신 실행을 시작할 수 있습니다. 그러면 Step Functions에서 별칭으로 지정된 버전을 실행합니다. 상태 머신 실행을 시작할 때 버전이나 별칭을 지정하지 않으면 Step Functions는 기본적으로 최신 버전을 사용합니다.
**별칭을 사용하여 상태 머신 실행 시작하기**
1. [Step Functions 콘솔](https://console.aws.amazon.com/states/home?region=us-east-1#/)을 열고 별칭을 만든 기존 상태 머신을 선택합니다. 별칭을 만드는 방법은 [상태 머신 별칭 만들기(콘솔)](#procedure-create-aliases) 섹션을 참조하세요.
1. **상태 머신 세부 정보** 페이지에서 **별칭** 탭을 선택합니다.
1. **별칭** 섹션에서 다음을 수행합니다.
1. 실행을 시작할 별칭을 선택합니다.
1. **실행 시작**을 선택합니다.
1. (선택 사항) **실행 시작** 대화 상자에 실행 이름을 입력합니다.
1. 필요한 경우 실행 입력을 입력한 다음 **실행 시작**을 선택합니다.