Step Functions 실행의 맵 실행 Redriving

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

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

상위 워크플로를 redriving하면 맵 실행에서 실패한 하위 워크플로 실행을 다시 시작할 수 있습니다. redriven 상위 워크플로에서 Distributed Map을 비롯한 실패한 모든 상태를 redrives합니다. 상위 워크플로에서 실행을 완료한 시점의 상태에 대한 <stateType>Entered 이벤트에 해당하는 <stateType>Exited 이벤트가 없으면 상위 워크플로는 실패한 상태를 리드라이브합니다. 예를 들어 이벤트 내역에 MapStateEntered 이벤트에 대한 MapStateExited 이벤트가 포함되어 있지 않으면 상위 워크플로를 redrive하여 맵 실행에서 실패한 모든 하위 워크플로 실행을 redrive할 수 있습니다.

상태 시스템에 ItemReader(맵), ResultWriter(맵) 또는 둘 다에 액세스하는 데 필요한 권한이 없으면 맵 실행이 원래 실행 시도에서 시작되지 않거나 실패합니다. 맵 실행이 상위 워크플로의 원래 실행 시도에서 시작되지 않은 경우 상위 워크플로를 redriving하면 맵 실행이 처음으로 시작됩니다. 이 문제를 해결하려면 상태 시스템 역할에 필요한 권한을 추가한 다음 상위 워크플로를 redrive합니다. 필요한 권한을 추가하지 않고 상위 워크플로를 redrive한 경우 새 맵 실행을 시작하려고 시도하면 다시 실패합니다. 필요할 수 있는 권한은 Distributed Map 상태를 사용하기 위한 IAM 정책 섹션을 참조하세요.

맵 실행에서 하위 워크플로에 대한 Redrive 적격성

다음 조건이 충족되면 맵 실행에서 실패한 하위 워크플로를 redrive할 수 있습니다.

맵 실행이 원래 실행 시도에서 실패했더라도 다음과 같은 경우에는 새 맵 실행이 시작되고 기존 맵 실행은 redriven되지 않습니다.

상위 워크플로가 중지되거나 시간 초과된 후에도 맵 실행은 계속 실행될 수 있습니다. 다음과 같은 시나리오에서는 redrive는 즉시 발생하지 않습니다.

이러한 경우에는 실행 중인 맵 실행이 redrive를 시도하기 전에 작업을 완료합니다.

하위 워크플로 실행 redrive 동작

맵 실행의 redriven 하위 워크플로 실행은 다음 표의 설명과 같은 동작을 나타냅니다.

맵 실행을 redriven하고 동시 한도에 도달하면 해당 맵 실행의 하위 워크플로 실행이 보류 중 상태로 전환됩니다. 맵 실행의 실행 상태도 redrive 보류 중 상태로 전환됩니다. 지정된 동시성 한도에서 더 많은 하위 워크플로 실행을 허용할 수 있을 때까지 실행은 redrive 보류 중 상태로 유지됩니다.

예를 들어 워크플로에 있는 분산 맵의 동시성 한도가 3000이고 재실행할 하위 워크플로 수가 6000개라고 가정해보겠습니다. 이로 인해 하위 워크플로가 3000개가 동시에 실행되고 나머지 워크플로 3000개는 리드라이브 보류 중 상태로 유지됩니다. 하위 워크플로 3000개의 첫 번째 배치가 실행을 완료하면 나머지 하위 워크플로 3000개가 실행됩니다.

맵 실행이 실행을 완료하거나 중단되면 redrive 보류 중 상태의 하위 워크플로 실행 수가 0으로 재설정됩니다.

맵 실행 redrive에서 사용된 입력 시나리오

원래 실행 시도에서 분산 맵에 입력을 제공한 방식에 따라 redriven 맵 실행은 다음 표의 설명대로 입력을 사용합니다.

맵 실행을 redrive할 수 있는 IAM 권한

Step Functions에는 맵 실행을 redrive할 수 있는 적절한 권한이 필요합니다. 다음 IAM 정책 예제에서는 맵 실행을 redriving하는 데 필요한 최소 권한을 상태 시스템에 부여합니다. 기울임꼴 텍스트를 리소스별 정보로 바꿔야 합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:RedriveExecution"
      ],
      "Resource": "arn:aws:states:us-east-2:123456789012:execution:myStateMachine/myMapRunLabel:*"
    }
  ]
}

콘솔에서 맵 실행 Redriving

다음 이미지에서는 분산 맵이 포함된 상태 시스템의 실행 그래프를 보여줍니다. 맵 실행이 실패하여 이 실행이 실패했습니다. 맵 실행을 redrive하려면 상위 워크플로를 redrive해야 합니다.

맵 실행을 redriven한 후에 콘솔에서 또는 GetExecutionHistory 및 DescribeExecution API 작업을 사용하여 redrive 세부 정보를 검사할 수 있습니다. redriven 실행 검사 방법에 대한 자세한 내용은 redriven 실행 검사 섹션을 참조하세요.

API를 사용하여 맵 실행 Redriving

상위 워크플로에서 RedriveExecution API를 사용하여 적합한 맵 실행을 redrive할 수 있습니다. 이 API는 맵 실행에서 실패한 하위 워크플로 실행을 다시 시작합니다.

AWS Command Line Interface (AWS CLI)에서 다음 명령을 실행하여 실패한 상태 시스템 실행을 redrive합니다. 기울임꼴 텍스트를 리소스별 정보로 바꿔야 합니다.

aws stepfunctions redrive-execution --execution-arn arn:aws:states:us-east-2:123456789012:execution:myStateMachine:foo

맵 실행을 redriven한 후에 콘솔에서 또는 DescribeMapRun API 작업을 사용하여 redrive 세부 정보를 검사할 수 있습니다. 맵 실행에서 표준 워크플로 실행의 redrive 세부 정보를 검사하려면 GetExecutionHistory 또는 DescribeExecution API 작업을 사용하면 됩니다. redriven 실행 검사 방법에 대한 자세한 내용은 redriven 실행 검사 섹션을 참조하세요.

상위 워크플로에서 로깅을 활성화한 경우 Step Functions 콘솔의 맵 실행에서 Express 워크플로 실행의 redrive 세부 정보를 검사할 수 있습니다. 자세한 내용은 CloudWatch Logs를 사용하여 Step Functions에서 실행 기록 로깅 단원을 참조하십시오.