Step Functions에서 이벤트에 대한 응답으로 상태 시스템 시작 - AWS Step Functions
사전 조건: 상태 시스템 생성1단계: Amazon S3에 버킷 만들기2단계: EventBridge로 Amazon S3 이벤트 알림 활성화3단계: Amazon EventBridge 규칙 만들기4단계: 규칙 테스트실행 입력의 예

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

Step Functions에서 이벤트에 대한 응답으로 상태 시스템 시작

Amazon EventBridge 규칙에 대한 응답으로 AWS Step Functions 상태 시스템을 실행할 수 있습니다.

이 자습서에서는 상태 시스템을 Amazon EventBridge 규칙의 대상으로 구성하는 방법을 보여줍니다. 이 규칙은 파일이 Amazon Simple Storage Service(S3) 버킷에 추가될 때 상태 시스템 실행을 시작합니다.

실용적 애플리케이션의 경우 섬네일 만들기나 이미지 및 비디오 파일에서 Amazon Rekognition 분석 실행과 같이 버킷에 추가하는 파일에서 작업을 수행하는 상태 시스템을 시작할 수 있습니다.

이 자습서에서는 파일을 Amazon S3 버킷에 업로드하여 Helloworld 상태 시스템 실행을 시작합니다. 그런 다음 해당 실행의 예제 입력을 검토하여 EventBridge로 전달된 Amazon S3 이벤트 알림의 입력에 포함된 정보를 식별합니다.

사전 조건: 상태 시스템 생성

상태 시스템을 Amazon EventBridge 대상으로 구성하려면 먼저 상태 시스템을 만들어야 합니다.

1단계: Amazon S3에 버킷 만들기

Helloworld 상태 시스템이 있으므로 이제 파일을 저장하는 Amazon S3 버킷을 만들어야 합니다. 이 자습서의 3단계에서는 파일이 이 버킷에 업로드될 때 EventBridge에서 상태 시스템 실행을 트리거하도록 규칙을 설정합니다.

  1. Amazon S3 콘솔로 이동한 다음 버킷 생성을 선택하여 파일을 저장하고 Amazon S3 이벤트 규칙을 트리거할 버킷을 만듭니다.

  2. 버킷 이름을 입력합니다(예: username-sfn-tutorial).

    참고

    버킷 이름은 Amazon S3의 모든 AWS 리전에 있는 모든 기존 버킷 이름에서 고유해야 합니다. 자신의 사용자 이름을 사용하여 이 이름을 고유하게 합니다. 동일한 AWS 리전의 모든 리소스를 생성해야 합니다.

  3. 페이지에 있는 모든 기본 선택 항목을 그대로 두고 버킷 생성을 선택합니다.

2단계: EventBridge로 Amazon S3 이벤트 알림 활성화

Amazon S3 버킷을 만든 후 S3 버킷에서 파일 업로드와 같은 특정 이벤트가 발생할 때마다 이벤트를 EventBridge로 보내도록 버킷을 구성합니다.

  1. Amazon S3 콘솔로 이동합니다.

  2. 버킷(Buckets) 목록에서 이벤트를 사용 설정하려는 버킷의 이름을 선택합니다.

  3. [속성(Properties)]을 선택합니다.

  4. 페이지를 아래로 스크롤하여 이벤트 알림 섹션을 본 다음 Amazon EventBridge 하위 섹션에서 편집을 선택합니다.

  5. 이 버킷의 모든 이벤트에 대해 Amazon EventBridge에 알림 보내기에서 켜기를 선택합니다.

  6. Save changes(변경 사항 저장)를 선택합니다.

    참고

    EventBridge를 사용 설정한 후에는 변경 사항이 적용되는 데 5분 정도 걸립니다.

3단계: Amazon EventBridge 규칙 만들기

상태 시스템이 있고 Amazon S3 버킷을 만들고 이벤트 알림을 EventBridge에 보내도록 구성했으면 EventBridge 규칙을 만듭니다.

참고

Amazon S3 버킷과 동일한 AWS 리전에 EventBridge 규칙을 구성해야 합니다.

규칙을 만들려면

  1. Amazon EventBridge 콘솔로 이동하고 규칙 생성을 선택합니다.

    작은 정보

    또는 EventBridge 콘솔의 탐색 창에서 버스에서 규칙을 선택한 다음 규칙 생성을 선택합니다.

  2. 규칙의 이름(예: S3Step Functions)을 입력하고 선택적으로 규칙에 대한 설명을 입력합니다.

  3. 이벤트 버스 및 규칙 유형에서는 기본 선택을 유지합니다.

  4. Next(다음)를 선택합니다. 그러면 이벤트 패턴 작성 페이지가 열립니다.

  5. 이벤트 패턴 섹션까지 아래로 스크롤하고 다음을 수행합니다.

    1. 이벤트 소스의 경우 기본 선택 항목 AWS 이벤트 또는 EventBridge 파트너 이벤트를 그대로 둡니다.

    2. AWS 서비스에 Simple Storage Service(S3)를 선택합니다.

    3. 이벤트 유형에 Amazon S3 이벤트 알림을 선택합니다.

    4. 특정 이벤트를 선택한 다음 생성된 객체를 선택합니다.

    5. 이름 기준 특정 버킷을 선택하고 1단계에서 만든 버킷 이름(username-sfn-tutorial)을 입력합니다.

    6. Next(다음)를 선택합니다. 그러면 대상 선택 페이지가 열립니다.

대상을 생성하려면

  1. 대상 1에서 기본 선택 항목 AWS 서비스를 그대로 둡니다.

  2. 대상 선택 드롭다운 목록에서 Step Functions 상태 시스템을 선택합니다.

  3. 상태 시스템 목록에서 이전에 만든 상태 시스템(예: Helloworld)을 선택합니다.

  4. 페이지에 있는 모든 기본 선택 항목을 그대로 두고 다음을 선택합니다. 그러면 태그 구성 페이지가 열립니다.

  5. 다음을 다시 선택합니다. 그러면 검토 및 생성 페이지가 열립니다.

  6. 규칙의 세부 정보를 검토하고 규칙 생성을 선택합니다.

    규칙이 생성되고 규칙 페이지에 모든 Amazon EventBridge 규칙이 나열됩니다.

4단계: 규칙 테스트

모두 구현되었으므로 Amazon S3 버킷에 파일 추가를 테스트한 다음 그에 따른 상태 시스템 실행의 입력을 살펴봅니다.

  1. 파일을 Amazon S3에서 버킷에 추가합니다.

    Amazon S3 콘솔로 이동하고 파일을 저장할 생성된 버킷을 선택한 다음(username-sfn-tutorial) 업로드를 선택합니다.

  2. 파일(예: test.png)을 추가한 다음 업로드를 선택합니다.

    이렇게 하면 상태 시스템의 실행이 시작되고 AWS CloudTrail에서 정보가 입력으로 전달됩니다.

  3. 상태 시스템의 실행을 점검합니다.

    Step Functions 콘솔로 이동하고 Amazon EventBridge 규칙(Helloworld)에 사용된 상태 시스템을 선택합니다.

  4. 해당 상태 시스템의 최근 실행을 선택하고 실행 입력 섹션을 확장합니다.

    이 입력에는 버킷 이름, 객체 이름 등의 정보가 포함되어야 합니다. 실제 사용 사례에서 상태 시스템은 이 입력을 사용하여 해당 객체에 대한 작업을 수행할 수 있습니다.

실행 입력의 예

다음 예제에서는 상태 시스템 실행에 대한 일반적인 입력을 보여줍니다.

{
    "version": "0",
    "id": "6c540ad4-0671-9974-6511-756fbd7771c3",
    "detail-type": "Object Created",
    "source": "aws.s3",
    "account": "123456789012",
    "time": "2023-06-23T23:45:48Z",
    "region": "us-east-2",
    "resources": [
      "arn:aws:s3:::username-sfn-tutorial"
    ],
    "detail": {
      "version": "0",
      "bucket": {
        "name": "username-sfn-tutorial"
      },
      "object": {
        "key": "test.png",
        "size": 800704,
        "etag": "f31d8546bb67845b4d3048cde533b937",
        "sequencer": "00621049BA9A8C712B"
      },
      "request-id": "79104EXAMPLEB723",
      "requester": "123456789012",
      "source-ip-address": "200.0.100.11",
      "reason": "PutObject"
    }
  }