View a markdown version of this page

Lambda 이벤트 소스 매핑 실행 블록 - Amazon Application Recovery Controller(ARC)

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

Lambda 이벤트 소스 매핑 실행 블록

Lambda 이벤트 소스 매핑 실행 블록을 사용하면 복구 작업의 일부로 Lambda 이벤트 소스 매핑을 활성화하거나 비활성화할 수 있습니다. 이벤트 소스 매핑은 Amazon Kinesis, Amazon DynamoDB Streams, Amazon Simple Queue Service, Amazon Managed Streaming for Apache Kafka(Amazon MSK)와 같은 이벤트 소스에서 읽고 레코드 배치로 Lambda 함수를 호출하는 Lambda 리소스입니다.

참고

이 실행 블록은 이벤트 소스 매핑만 관리합니다. Amazon S3, Amazon Simple Notification Service 및 Amazon Simple Email Service와 같은 서비스의 서비스 측 이벤트 기반 호출인 Lambda 트리거는이 실행 블록에서 지원되지 않습니다.

구성

이 블록은 한 번에 하나의 이벤트 소스 매핑 리소스에 대해 하나의 작업(활성화 또는 비활성화)을 수행하도록 구성할 수 있습니다.

Lambda 이벤트 소스 매핑 실행 블록을 구성하려면 다음 값을 입력합니다.

중요

실행 블록을 구성하기 전에 계획의 실행 역할에 올바른 IAM 정책이 있는지 확인합니다. 자세한 내용은 Lambda 이벤트 소스 매핑 실행 블록 샘플 정책 단원을 참조하십시오.

  1. 단계 이름: 이름을 입력합니다.

  2. 설명(선택 사항): 단계에 대한 설명을 입력합니다.

  3. 작업: 이 단계가 실행될 때 이벤트 소스 매핑을 활성화할지 아니면 비활성화할지 선택합니다.

  4. Region-1을 활성화/비활성화할 때 활성화 또는 비활성화할 Lambda 이벤트 소스 매핑 ARN: Region-1을 활성화/비활성화할 때 조치를 취할 이벤트 소스 매핑 ARN을 입력합니다.

  5. Region-2를 활성화/비활성화할 때 활성화 또는 비활성화할 Lambda 이벤트 소스 매핑 ARN: Region-2를 활성화/비활성화할 때 조치를 취할 이벤트 소스 매핑 ARN을 입력합니다.

  6. 제한 시간: 제한 시간 값을 입력합니다.

  7. 부실 실행: 부실(계획되지 않은) 실행 중에이 실행 블록을 건너뛸지 여부를 선택합니다.

그런 다음 단계 저장을 선택합니다.

이벤트 소스 매핑은 계획이 구성된 리전 중 하나에 있어야 합니다. 그러나 활성화하려는 리전과 이벤트 소스 매핑이 실행되는 리전은 일치할 필요가 없습니다.

예를 들어 다른 리전을 활성화할 때 비활성화 리전에서 이벤트 처리를 비활성화하려면

  • us-west-2를 활성화할 때 비활성화할 이벤트 소스 매핑 ARN: arn:aws:lambda:us-east-1:123456789012:event-source-mapping:uuid-1.

  • us-east-1을 활성화할 때 비활성화할 이벤트 소스 매핑 ARN: arn:aws:lambda:us-west-2:123456789012:event-source-mapping:uuid-2.

이 블록은 정상 실행 모드와 비정상 실행 모드를 모두 지원합니다. Ungraceful 모드는 계획되지 않은 장애 조치 시나리오를 위해 설계되었습니다. 일반적으로 단계가 비활성화 리전에서 작업을 수행하도록 구성된 경우이 실행 블록에서 성능 저하 실행 중에 단계 건너뛰기를 활성화합니다. 장애 조치 중에 비활성화 리전에서 이벤트 처리를 중지하고 활성화 리전에서 처리를 시작할 수 있습니다. 이를 위해 두 개의 Lambda 이벤트 소스 매핑 실행 블록을 순서대로 설정합니다. 하나는 비활성화 리전에서 이벤트 소스 매핑 리소스를 비활성화하고 다른 하나는 활성화 리전에서 이벤트 소스 매핑 리소스를 활성화합니다.

작동 방식

Lambda 이벤트 소스 매핑 실행 블록은 Lambda 함수에서 이벤트 소스 매핑을 활성화하거나 비활성화합니다. 계획 실행 중에 블록이 호출되면 리전 스위치는 Lambda UpdateEventSourceMapping API를 호출하여 지정된 Lambda 이벤트 소스 매핑에서 구성된 작업(활성화 또는 비활성화)을 수행합니다. 그런 다음 리전 전환은 이벤트 소스 매핑이 대상 상태에 도달할 때까지 기다렸다가 계획의 다음 단계로 진행하기 전에이 단계의 상태(실패로 인해 완료 또는 일시 중지됨)를 업데이트합니다. 매핑이 이미 원하는 상태인 경우 리전 스위치는 단계를 즉시 완료로 표시합니다. 성능 저하 실행을 위해 구성된이 실행 블록이 포함된 계획이 성능 저하 모드에서 실행되면 계획은이 단계의 실행을 건너뜁니다.

계획 평가의 일부로 평가되는 항목

리전 전환이 계획을 평가할 때 리전 전환은 Lambda 이벤트 소스 매핑 실행 블록 구성 및 권한에 대해 몇 가지 검사를 수행합니다. 리전 전환은 다음이 올바른지 확인합니다.

  • 이벤트 소스 매핑은 ARN에 포함된 리전에 존재합니다.

  • 이벤트 소스 매핑과 연결된 Lambda 함수가 있습니다.

  • 이벤트 소스 매핑 ARN의 임베디드 리전은 계획의 구성된 리전 중 하나입니다.

  • 활성화 작업의 경우: Lambda 함수가 제한되지 않습니다(프로비저닝된 동시성이 0으로 설정되지 않음).

  • 활성화 작업의 경우: Lambda 함수가 활성 상태입니다.

리전 스위치는 또한 계획의 IAM 역할에 이벤트 소스 매핑을 관리하는 데 필요한 권한이 있는지 확인합니다. 리전 전환 실행 블록에 필요한 권한에 대한 자세한 내용은 ARC 리전 전환에 대한 자격 증명 기반 정책 예제 섹션을 참조하세요.

Lambda 이벤트 소스 매핑 실행 블록이 제대로 작동하려면 올바른 IAM 권한이 필요합니다. 이러한 검증 중 하나라도 실패하면 리전 전환은 문제가 있다는 경고를 반환하고, 권한 또는 구성 문제를 해결하는 데 도움이 되는 특정 오류 메시지를 제공합니다.