Step Functions 워크플로의 스테이트 머신 버전 - AWS Step Functions
상태 시스템 버전 게시(콘솔)를 사용한 버전 관리 APIs콘솔에서 상태 시스템 버전 실행

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

Step Functions 워크플로의 스테이트 머신 버전

버전은 번호가 매겨져 있으며 변경할 수 없는 상태 시스템 스냅샷입니다. 해당 상태 시스템에 적용된 최신 버전에서 버전을 게시합니다. 각 버전에는 고유한 Amazon 리소스 이름 (ARN) 이 있습니다. ARN이것은 상태 ARN 머신과 버전 번호를 콜론 (:) 으로 구분한 조합입니다. 다음 예제는 스테이트 머신 버전의 ARN 형식을 보여줍니다.

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

상태 시스템 버전을 사용하려면 첫 번째 버전을 게시해야 합니다. 버전을 게시한 후 해당 버전을 사용하여 StartExecutionAPI작업을 호출할 수 있습니다. ARN 버전을 편집할 수 없지만 상태 시스템을 업데이트하고 새 버전을 게시할 수 있습니다. 상태 시스템 버전 여러 개를 게시할 수도 있습니다.

버전이 상태 머신의 변경 불가능한 스냅샷이라는 것을 보여주는 퍼지 예시 다이어그램입니다.

새 상태 시스템 버전을 게시하면 Step Functions에서 버전 번호를 할당합니다. 버전 번호는 1부터 시작하며 새 버전이 나올 때마다 단조롭게 증가합니다. 지정된 상태 시스템에는 버전 번호가 다시 사용되지 않습니다. 상태 시스템 버전 10을 삭제한 다음 새 버전을 게시하면 Step Functions에서 상태 시스템을 버전 11로 게시합니다.

다음 속성은 상태 시스템의 모든 버전에서 동일합니다.

  • 상태 시스템의 모든 버전은 동일한 유형(표준 또는 Express)을 공유합니다.

  • 버전 간에 상태 시스템 이름이나 만든 날짜를 변경할 수 없습니다.

  • 태그는 전역적으로 상태 시스템에 적용됩니다. 및 작업을 사용하여 상태 머신의 태그를 관리할 수 있습니다. TagResourceUntagResourceAPI

상태 시스템에도 각 버전 및 revision에 속하는 속성이 포함되지만 이러한 속성은 두 가지 지정된 버전이나 개정마다 다를 수 있습니다. 이러한 속성에는 스테이트 머신 정의, IAM역할, 추적 구성 및 로깅 구성이 포함됩니다.

상태 시스템 버전 게시(콘솔)

상태 시스템 버전을 최대 1,000개까지 게시할 수 있습니다. 이 소프트 한도 증가를 요청하려면 AWS Management Console의 지원 센터 페이지를 사용합니다. 콘솔에서 사용하지 않는 버전을 수동으로 삭제하거나 작업을 호출하여 삭제할 수 있습니다. DeleteStateMachineVersionAPI

상태 머신 버전 게시하기

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

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

  3. 필요에 따라 상태 시스템 정의를 편집한 다음 저장을 선택합니다.

  4. Publish version(버전 게시)을 선택합니다.

  5. (선택 사항) 나타나는 대화 상자의 설명 필드에 상태 시스템 버전에 대한 간략한 설명을 입력합니다.

  6. 게시를 선택합니다.

참고

새 상태 시스템 버전을 게시하면 Step Functions에서 버전 번호를 할당합니다. 버전 번호는 1부터 시작하며 새 버전이 나올 때마다 단조롭게 증가합니다. 지정된 상태 시스템에는 버전 번호가 다시 사용되지 않습니다. 상태 시스템 버전 10을 삭제한 다음 새 버전을 게시하면 Step Functions에서 상태 시스템을 버전 11로 게시합니다.

Step Functions API 작업을 통한 버전 관리

Step Functions는 상태 머신 버전을 게시하고 관리하기 위한 다음과 같은 API 작업을 제공합니다.

  • PublishStateMachineVersion— 상태 revision 머신의 최신 버전을 게시합니다.

  • UpdateStateMachine— 상태 컴퓨터를 업데이트하고 동일한 true 요청에서 publish 매개 변수를 로 설정한 경우 새 상태 컴퓨터 버전을 게시합니다.

  • CreateStateMachine— publish 매개 변수를 로 설정한 경우 상태 머신의 첫 번째 개정판을 게시합니다. true

  • ListStateMachineVersions— 지정된 상태 머신의 ARN 버전을 나열합니다.

  • DescribeStateMachine— 에서 ARN 지정한 버전의 상태 시스템 버전 세부 정보를 반환합니다stateMachineArn.

  • DeleteStateMachineVersion— 스테이트 머신 버전을 삭제합니다.

를 myStateMachine 사용하여 호출한 상태 머신의 현재 버전에서 새 버전을 게시하려면 다음 publish-state-machine-version 명령을 사용합니다. AWS Command Line Interface

aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine

응답은 stateMachineVersionArn을 반환합니다. 예를 들어 이전 명령은 arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:1에 대한 응답을 반환합니다.

참고

새 상태 시스템 버전을 게시하면 Step Functions에서 버전 번호를 할당합니다. 버전 번호는 1부터 시작하며 새 버전이 나올 때마다 단조롭게 증가합니다. 지정된 상태 시스템에는 버전 번호가 다시 사용되지 않습니다. 상태 시스템 버전 10을 삭제한 다음 새 버전을 게시하면 Step Functions에서 상태 시스템을 버전 11로 게시합니다.

콘솔에서 상태 시스템 버전 실행

상태 시스템 버전을 시작하려면 먼저 현재 상태 시스템 revision에서 버전을 게시해야 합니다. 버전을 게시하려면 Step Functions 콘솔을 사용하거나 PublishStateMachineVersionAPI작업을 호출하십시오. 이름이 지정된 선택적 매개 변수를 사용하여 UpdateStateMachineAliasAPI작업을 publish 호출하여 상태 머신을 업데이트하고 해당 버전을 게시할 수도 있습니다.

콘솔을 사용하거나 StartExecutionAPI작업을 호출하고 버전을 제공하여 버전 실행을 시작할 수 있습니다. ARN 별칭을 사용하여 버전 실행을 시작할 수도 있습니다. 라우팅 구성에 따라 별칭에서 트래픽을 특정 버전으로 라우팅합니다.

버전을 사용하지 않고 상태 시스템 실행을 시작하면 Step Functions는 상태 시스템 최신 개정을 실행에 사용합니다. Step Functions에서 실행을 버전과 연결하는 방식은 실행을 버전 또는 별칭과 연결 섹션을 참조하세요.

상태 시스템 버전을 사용하여 실행 시작하기

  1. Step Functions 콘솔을 열고 버전을 하나 이상 게시한 기존 상태 시스템을 선택합니다. 버전을 게시하는 방법은 상태 시스템 버전 게시(콘솔) 섹션을 참조하세요.

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

  3. 버전 섹션에서 다음을 수행합니다.

    1. 실행을 시작할 버전을 선택합니다.

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

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

  5. (선택 사항) 실행 입력을 입력한 다음 실행 시작을 선택합니다.