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

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

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

이 자습서에서는 함수를 호출하는 AWS Step Functions 데 사용하는 1단계 워크플로를 생성합니다. AWS Lambda

참고

Step Functions는 스테이트 머신과 태스크를 기반으로 합니다. Step Functions에서는 상태 머신을 워크플로라고 하며, 워크플로우는 일련의 이벤트 기반 단계입니다. 워크플로의 각 단계를 상태라고 합니다. 예를 들어 작업 상태는 다른 AWS 서비스 서비스나 API 호출과 같이 다른 AWS 서비스가 수행하는 작업 단위를 나타냅니다.

자세한 내용은 다음을 참조하세요.

Lambda 함수는 서버리스이고 작성하기 쉬우므로 Lambda는 Task 상태에 매우 적합합니다. AWS Management Console 또는 선호하는 편집기에서 코드를 작성할 수 있습니다. AWS 함수에 컴퓨팅 환경을 제공하고 함수를 실행하는 세부 정보를 처리합니다.

1단계: Lambda 함수 생성

Lambda 함수는 이벤트 데이터를 수신하고 인사말 메시지를 반환합니다.

중요

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

  1. Lambda 콘솔을 열고 함수 생성을 선택합니다.

  2. 함수 생성 페이지에서 처음부터 새로 작성을 선택합니다.

  3. [함수 이름]에 HelloFunction을 입력합니다.

  4. 다른 모든 옵션에는 기본 선택 항목을 그대로 둔 다음 함수 생성을 선택합니다.

  5. Lambda 함수를 만든 후 페이지 오른쪽 상단 모서리에 표시된 함수의 Amazon 리소스 이름(ARN)을 복사합니다. ARN을 복사하려면 copy Amazon Resource Name 을 클릭합니다. ARN 예제는 다음과 같습니다.

    arn:aws:lambda:us-east-1:123456789012:function:HelloFunction
  6. Lambda 함수의 다음 코드를 페이지의 코드 소스 섹션에 복사합니다. HelloFunction

    export const handler = async(event, context, callback) => { callback(null, "Hello from " + event.who + "!"); };

    이 코드는 입력 데이터의 who 필드를 사용하여 인삿말을 수집합니다. 이때 입력 데이터는 함수로 전달되는 event 객체가 전달한 것입니다. 이 함수의 입력 데이터는 나중에 새로 실행을 시작할 때 추가합니다. callback 메서드는 함수로부터 수집된 인삿말을 반환합니다.

  7. 배포를 선택합니다.

2단계: Lambda 함수 테스트

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

  1. 테스트를 선택합니다.

  2. 이벤트 이름HelloEvent를 입력합니다.

  3. 이벤트 JSON 데이터를 다음으로 바꿉니다.

    { "who": "AWS Step Functions" }

    "who" 항목은 Lambda 함수의 event.who 필드에 해당하며 인사말을 완성합니다. 상태 시스템을 실행할 때 같은 입력 데이터를 입력합니다.

  4. 저장를 선택한 다음 테스트를 선택합니다.

  5. 테스트 결과를 확인하려면 실행 결과(Execution result)에서 세부 정보(Details)를 확장합니다.

3단계: 상태 시스템 만들기

Step Functions 콘솔을 사용하여 1단계에서 만든 Lambda 함수를 간접적으로 호출하는 상태 시스템을 만듭니다.

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

    중요

    스테이트 머신이 이전에 생성한 Lambda 함수와 동일한 AWS 계정 및 리전에 속하는지 확인하십시오.

  2. 템플릿 선택 대화 상자에서 공백을 선택합니다.

  3. 선택을 선택하세요. 디자인 모드에서 Workflow Studio가 열립니다.

  4. 왼쪽의 상태 브라우저에서 작업 탭을 선택했는지 확인합니다. 뒤이어 다음과 같이 하세요.

    1. AWS Lambda Invoke API를 끌어 첫 번째 상태를 여기에 놓기 레이블이 지정된 빈 상태에 놓습니다.

      상태 브라우저
  5. 오른쪽의 Inspector 패널에서 Lambda 함수를 구성합니다.

    1. API 파라미터 섹션의 함수 이름 드롭다운 목록에서 이전에 만든 Lambda 함수를 선택합니다.

    2. 페이로드 드롭다운 목록에 기본 선택 항목을 그대로 둡니다.

  6. (선택 사항) 정의를 선택하여 상태 시스템 Amazon States Language(ASL) 정의를 봅니다. 이 정의는 작업 탭과 Inspector 패널에서의 선택 항목에 따라 자동으로 생성됩니다.

  7. 상태 시스템 이름을 지정합니다. 이렇게 하려면 기본 상태 시스템 이름 옆에 있는 편집 아이콘을 선택하십시오. MyStateMachine 그런 다음 상태 머신 구성에서 상태 머신 이름 상자에 이름을 지정합니다.

    예를 들어 LambdaStateMachine 이름을 입력합니다.

    참고

    상태 머신, 실행 및 활동 태스크의 이름은 80자를 초과하면 안 됩니다. 이러한 이름은 계정 및 AWS 지역별로 고유해야 하며 다음 내용을 포함하지 않아야 합니다.

    • 공백

    • 와일드카드 문자 (? *)

    • 괄호 문자(< > { } [ ])

    • 특수 문자 (" # % \ ^ | ~ ` $ & , ; : /)

    • 제어 문자(\\u0000 - \\u001f 또는 \\u007f - \\u009f).

    상태 시스템이 Express 유형이면 상태 시스템 실행 여러 개에 같은 이름을 제공할 수 있습니다. Step Functions는 여러 실행 이름이 같더라도 Express 상태 시스템 실행마다 고유한 실행 ARN을 생성합니다.

    Step Functions를 사용하면 상태 머신, 실행 및 활동의 이름과 ASCII가 아닌 문자가 포함된 레이블을 만들 수 있습니다. 이러한 비 ASCII 이름은 Amazon에서 사용할 수 없습니다. CloudWatch CloudWatch 지표를 추적할 수 있도록 하려면 ASCII 문자만 사용하는 이름을 선택하십시오.

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

    이 자습서의 경우 상태 머신 설정의 모든 기본 선택 항목을 그대로 둡니다.

  9. 생성을 선택합니다.

  10. 역할 생성 확인 대화 상자에서 확인을 선택하여 계속합니다.

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

    참고

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

4단계: 상태 시스템 실행

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

  1. 상태 머신 페이지에서 원하는 항목을 선택합니다. LambdaStateMachine

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

    실행 시작 대화 상자가 표시됩니다.

  3. (선택 사항) 실행을 식별하려면 이름 상자에 해당 실행의 이름을 지정하면 됩니다. 기본적으로 Step Functions는 고유한 실행 이름을 자동으로 생성합니다.

    참고

    Step Functions를 사용하면 상태 머신, 실행 및 활동의 이름과 ASCII가 아닌 문자가 포함된 레이블을 만들 수 있습니다. 이러한 비 ASCII 이름은 Amazon에서 사용할 수 없습니다. CloudWatch CloudWatch 지표를 추적할 수 있도록 하려면 ASCII 문자만 사용하는 이름을 선택하십시오.

  4. 입력 영역에서 예제 실행 데이터를 다음으로 바꿉니다.

    { "who" : "AWS Step Functions" }

    "who"는 인사할 사람 이름을 가져오기 위해 Lambda 함수에서 사용하는 키 이름입니다.

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

    상태 시스템 실행이 시작되고 실행 중인 실행을 보여주는 새로운 페이지가 표시됩니다.

  6. Step Functions 콘솔은 실행 ID가 제목인 페이지로 이동합니다. 이 페이지를 실행 세부 정보 페이지라고 합니다. 실행이 진행되는 동안 또는 완료된 후에 이 페이지에서 실행 결과를 검토할 수 있습니다.

    실행 결과를 검토하려면 그래프 보기에서 개별 상태를 선택한 다음 단계 세부 정보 창에서 개별 탭을 선택하여 입력, 출력 및 정의가 포함된 각 상태의 세부 정보를 각각 봅니다. 실행 세부 정보 페이지에서 볼 수 있는 실행 정보에 대한 자세한 내용은 실행 세부 정보 페이지 - 인터페이스 개요 섹션을 참조하세요.

    단계 세부 정보 창의 출력 탭에는 상태 시스템 실행에서 반환된 출력이 표시됩니다.
참고

상태 시스템에서 Lambda를 간접적으로 호출하는 동안 페이로드를 전달할 수도 있습니다. Parameters 필드에 페이로드를 전달하여 Lambda를 간접적으로 호출하는 방법에 대한 자세한 내용과 예제는 Step Functions를 사용하여 Lambda 간접 호출 섹션을 참조하세요.