ipa-stack-queue

Deploy an SQS queue tier with DLQ, worker Lambda, DynamoDB, and CloudWatch.

1|1|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/aws-samples/sample-innovation-patterns --skill ipa-stack-queue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ipa-stack-queue
Source: https://github.com/aws-samples/sample-innovation-patterns/tree/main/.claude/skills/ipa-stack-queue
Command: npx skills add https://github.com/aws-samples/sample-innovation-patterns --skill ipa-stack-queue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the manual, error-prone work of provisioning a complete AWS queue tier (SQS/DLQ, worker Lambda, supporting data stores, and observability) so you can run background jobs reliably in your application environment.

Core Features & Use Cases

  • Queue + Dead-Letter Queue (DLQ): Creates an SQS queue with optional DLQ support for safer message retries and failure handling.
  • Worker Lambda (container-based) + ES Modules: Deploys a worker Lambda that runs from the shared container image with an overridable command entrypoint.
  • Feature-flagged Jobs DynamoDB: Optionally provisions a DynamoDB jobs table and connects the needed IAM policies/outputs for tracking.
  • CloudWatch dashboards and alarms: Produces operational visibility for the queue and related failure modes, including DLQ-related alarms when enabled.
  • Secure, composable stack identity: Uses a consistent stack naming scheme and exports outputs intended for wiring into the backend stack.

Quick Start

Instruct the AI to deploy the queue tier by running the ipa-stack-queue skill with your APP_NAMESPACE, APP_ENV, ECR ImageUri, and Cognito AuthIssuer/AuthAudience, enabling the jobs table for job tracking.

Frequently Asked Questions about ipa-stack-queue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy an SQS queue with a Lambda worker for background processing?

To deploy an SQS queue with a Lambda worker, this skill provisions the complete tier including a container-based Lambda, optional DLQ, and CloudWatch alarms. It requires stack parameters for namespace, environment, ECR image URI, and Cognito OIDC settings.

How do I set up a dead-letter queue for SQS message retries and failure isolation?

Setting up a dead-letter queue for SQS retries is handled by conditionally creating a DLQ resource alongside the primary queue. The skill configures DLQ-related CloudWatch alarms and failure isolation to safely handle asynchronous job failures across environments.

Can I use a container image for my Lambda worker with SQS?

Yes, you can use a container image for your Lambda worker with SQS. The skill deploys a worker Lambda running from a shared container image specified by an ECR image URI, allowing an overridable command entrypoint for flexible job execution.

How do I add a DynamoDB jobs table for tracking SQS background tasks?

Adding a DynamoDB jobs table for tracking SQS tasks is supported through a feature-flagged provision. The skill optionally creates the DynamoDB table and automatically connects the necessary IAM policies and stack outputs for backend wiring.

What AWS resources are required to build a serverless background job system?

Building a serverless background job system requires SQS queues, a worker Lambda, and observability tools. This skill provisions these resources together, adding a feature-flagged DynamoDB jobs table and CloudWatch dashboards for dependable asynchronous job submission.

Do I need Cognito OIDC configuration to deploy an SQS queue tier?

Yes, Cognito OIDC configuration is required to deploy this SQS queue tier. You must provide Cognito AuthIssuer and AuthAudience stack parameters to enforce secure, composable stack identity before creating the queue and worker resources.