1단계: 실패하는 Lambda 함수 만들기 2단계: Lambda 함수 테스트 3단계: Catch 필드를 사용하여 상태 시스템 만들기 4단계: 상태 시스템 실행

Step Functions 상태 시스템을 사용하여 오류 조건 처리

이 자습서에서는 폴백 상태 필드를 사용하여 AWS Step Functions 스테이트 머신을 생성합니다. Catch필드는 AWS Lambda 함수를 사용하여 오류 메시지 유형에 따른 조건부 로직으로 응답합니다. 이 기법을 함수 오류 처리라고 합니다.

자세한 내용은 AWS Lambda 개발자 안내서의 Node.js에서AWS Lambda 함수 오류를 참조하세요.

참고

시간 초과 시 Retry하거나 오류가 발생하거나 시간이 초과될 때 Catch를 사용하여 특정 상태로 전환되는 상태 시스템도 만들 수 있습니다. 오류 처리 기술의 예는 Retry 및 Catch 사용 예제를 참조하십시오.

1단계: 실패하는 Lambda 함수 만들기

Lambda 함수를 사용하면 오류 조건을 시뮬레이션할 수 있습니다.

중요

Lambda 함수가 상태 머신과 AWS 동일한 계정 AWS 및 지역에 속하는지 확인하십시오.

https://console.aws.amazon.com/lambda/ 에서 AWS Lambda 콘솔을 엽니다.
함수 생성을 선택합니다.
블루프린트 사용을 선택하고 검색 상자에 step-functions를 입력한 다음 사용자 지정 오류 발생 청사진을 선택합니다.
[함수 이름]에 FailFunction을 입력합니다.
역할의 경우 기본 선택 항목(기본 Lambda 권한으로 새 역할 생성)을 그대로 둡니다.

Lambda 함수 코드 창에 다음 코드가 표시됩니다.


exports.handler = async (event, context) => {
    function CustomError(message) {
        this.name = 'CustomError';
        this.message = message;
    }
    CustomError.prototype = new Error();

    throw new CustomError('This is a custom error!');
};

context 객체가 오류 메시지 This is a custom error!를 반환합니다.

함수 생성을 선택합니다.
Lambda 함수를 만든 후 페이지 오른쪽 상단 모서리에 표시된 함수의 Amazon 리소스 이름(ARN)을 복사합니다. ARN을 복사하려면 을 클릭합니다. ARN 예제는 다음과 같습니다.
```
arn:aws:lambda:us-east-1:123456789012:function:FailFunction
```
배포를 선택합니다.

2단계: Lambda 함수 테스트

Lambda 함수를 테스트하여 작동 상태를 확인합니다.

FailFunction페이지에서 테스트 탭을 선택한 다음 테스트를 선택합니다. 테스트 이벤트를 만들 필요는 없습니다.
테스트 결과(시뮬레이션된 오류)를 확인하려면 실행 결과에서 세부 정보를 확장합니다.

3단계: Catch 필드를 사용하여 상태 시스템 만들기

Step Functions 콘솔을 사용하여 Catch 필드와 함께 작업 상태를 사용하는 상태 시스템을 만듭니다. Task 상태의 Lambda 함수에 참조를 추가합니다. 상태 시스템에서 Lambda 함수를 간접적으로 호출하지만 실행 중에 실패합니다. Step Functions는 재시도 간에 지수 백오프를 사용하여 함수를 두 번 재시도합니다.

Step Functions 콘솔을 열고 상태 시스템 생성을 선택합니다.
템플릿 선택 대화 상자에서 공백을 선택합니다.
선택을 선택하세요. 디자인 모드에서 Workflow Studio가 열립니다.
코드를 선택하여 코드 편집기를 엽니다. 코드 편집기에서 워크플로의 Amazon States Language(ASL) 정의를 작성하고 편집합니다.

다음 코드를 붙여넣되 Resource 필드에서 이전에 만든 Lambda 함수의 ARN을 바꿉니다.


{
   "Comment": "A Catch example of the Amazon States Language using an AWS Lambda function",
   "StartAt": "CreateAccount",
   "States": {
      "CreateAccount": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:FailFunction",
         "Catch": [ {
            "ErrorEquals": ["CustomError"],
            "Next": "CustomErrorFallback"
         }, {
            "ErrorEquals": ["States.TaskFailed"],
            "Next": "ReservedTypeFallback"
         }, {
            "ErrorEquals": ["States.ALL"],
            "Next": "CatchAllFallback"
         } ],
         "End": true
      },
      "CustomErrorFallback": {
         "Type": "Pass",
         "Result": "This is a fallback from a custom Lambda function exception",
         "End": true
      },
      "ReservedTypeFallback": {
         "Type": "Pass",
         "Result": "This is a fallback from a reserved error code",
         "End": true
      },
      "CatchAllFallback": {
         "Type": "Pass",
         "Result": "This is a fallback from any error code",
         "End": true
      }
   }
}

이 예제는 Amazon States Language를 사용하는 상태 시스템에 대한 설명입니다. 이 예에서는 CreateAccount라는 하나의 Task 상태를 정의합니다. 자세한 내용은 상태 머신 구조를 참조하십시오.

Retry 필드의 구문에 대한 자세한 내용은 Retry 및 Catch를 사용하는 상태 시스템 예제 단원을 참조하십시오.

참고

Lambda에서 처리되지 않은 오류는 오류 출력에서 Lambda.Unknown으로 보고됩니다. 여기에는 out-of-memory 오류와 함수 타임아웃이 포함됩니다. Lambda.Unknown, States.ALL 또는 States.TaskFailed를 일치시켜 이러한 오류를 처리할 수 있습니다. Lambda에서 최대 간접 호출 수에 도달하면 오류는 Lambda.TooManyRequestsException입니다. Lambda 함수 오류에 대한 자세한 내용은 AWS Lambda 개발자 안내서의 오류 처리 및 자동 재시도를 참조하세요.

(선택 사항) 그래프 시각화 창에서 워크플로의 실시간 그래픽 시각화를 확인합니다.
상태 시스템 이름을 지정합니다. 이렇게 하려면 기본 상태 머신 이름 옆에 있는 편집 아이콘을 선택합니다. MyStateMachine 그런 다음 상태 머신 구성에서 상태 머신 이름 상자에 이름을 지정합니다.

이 자습서에서는 Catchfailure을 입력합니다.
(선택 사항) 상태 머신 구성에서 상태 시스템 유형 및 실행 역할과 같은 기타 워크플로 설정을 지정합니다.

이 자습서의 경우 상태 머신 설정의 모든 기본 선택 항목을 그대로 둡니다.
역할 생성 확인 대화 상자에서 확인을 선택하여 계속합니다.

역할 설정 보기를 선택하여 상태 머신 구성으로 돌아갈 수도 있습니다.

참고
Step Functions에서 만드는 IAM 역할을 삭제하면 나중에 Step Functions에서 이 역할을 다시 만들 수 없습니다. 마찬가지로, 역할을 수정하면(예: IAM 정책의 주요에서 Step Functions 제거) 나중에 Step Functions에서 해당 원본 설정을 복원할 수 없습니다.

4단계: 상태 시스템 실행

상태 시스템을 만든 후에 실행할 수 있습니다.

상태 시스템 페이지에서 Catchfailure를 선택합니다.
Catchfailure 페이지에서 실행 시작을 선택합니다. 실행 시작 대화 상자가 표시됩니다.
실행 시작 대화 상자에서 다음을 수행합니다.
1. (선택 사항) 실행을 식별하려면 이름 상자에 해당 실행의 이름을 지정하면 됩니다. 기본적으로 Step Functions는 고유한 실행 이름을 자동으로 생성합니다.
  
  참고
  Step Functions를 사용하면 상태 머신, 실행 및 활동의 이름과 ASCII가 아닌 문자가 포함된 레이블을 만들 수 있습니다. 이러한 비 ASCII 이름은 Amazon에서 사용할 수 없습니다. CloudWatch CloudWatch 지표를 추적할 수 있도록 하려면 ASCII 문자만 사용하는 이름을 선택하십시오.
2. (선택 사항) 입력 상자에 입력 값을 JSON 형식으로 입력하여 워크플로를 실행합니다.
3. 실행 시작을 선택합니다.
4. Step Functions 콘솔은 실행 ID가 제목인 페이지로 이동합니다. 이 페이지를 실행 세부 정보 페이지라고 합니다. 실행이 진행되는 동안 또는 완료된 후에 이 페이지에서 실행 결과를 검토할 수 있습니다.
  
  실행 결과를 검토하려면 그래프 보기에서 개별 상태를 선택한 다음 단계 세부 정보 창에서 개별 탭을 선택하여 입력, 출력 및 정의가 포함된 각 상태의 세부 정보를 각각 봅니다. 실행 세부 정보 페이지에서 볼 수 있는 실행 정보에 대한 자세한 내용은 실행 세부 정보 페이지 - 인터페이스 개요 섹션을 참조하세요.
예를 들어 사용자 지정 오류 메시지를 보려면 그래프 보기에서 CreateAccount단계를 선택한 다음 출력 탭을 선택합니다.

참고
ResultPath를 사용하여 오류와 함께 상태 입력을 보존할 수 있습니다. ResultPath a에 오류와 입력을 모두 포함하는 데 사용합니다. Catch 섹션을 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

Lambda를 사용하는 Step Functions 상태 시스템 만들기

Inline Map 상태를 사용하여 작업 반복