@you54f/serverless-offline-sqs-dlq

Enable Dead-Letter-Queue with AWS λ and SQS locally when developing your Serverless project

Usage no npm install needed!

<script type="module">
  import you54fServerlessOfflineSqsDlq from 'https://cdn.skypack.dev/@you54f/serverless-offline-sqs-dlq';
</script>

README

serverless-offline-sqs-dlq

This Serverless-offline plugin brings Dead-Letter Queues to AWS λ and SQS queue on your local machine. It extends serverless-offline-sqs and thus depends on it.

Warning: Serverless doesn't support yet SQS for DLQ. After the deployment on AWS, the DLQ needs to be set on AWS (either manually or by a script).

Installation

First, ensure to have serverless-offline-sqs included in your project:

npm install serverless-offline-sqs serverless-offline-sqs-dlq

Then inside your project's serverless.yml file, add following entries to the plugins section before serverless-offline (and after serverless-webpack if presents).

plugins:
  - serverless-webpack
  - serverless-offline-sqs
  - serverless-offline-sqs-dlq
  - serverless-offline

Configure

Usage:

functions:
  basicLambda:
    handler: index.basicLambda
    events:
      - sqs: arn:aws:sqs:eu-west-1:XXXXXXX:basicLambdaTriggerQueue
  handleErrorLambda:
    handler: index.handleErrorLambda
    events:
      - sqs: arn:aws:sqs:eu-west-1:XXXXXXX:handleErrorLambdaQueue

Specify in the custom section which function handles errors:

custom:
  (...)
  serverless-offline-sqs-dlq:
    basicLambda:
      onError: handleErrorLambda
      maxReceiveCount: 3