processing-s3-uploads-with-step-functions

Installation
SKILL.md

Step Functions Workflow: Route S3 Uploads to Lambda or Fargate

Overview

This skill deploys an event-driven workflow using AWS CLI. When a file is uploaded to an S3 bucket, EventBridge triggers a Step Functions state machine. The state machine checks the file size and routes processing to either a Lambda function (files ≤ 6 MB) or a Fargate task (files > 6 MB).

The architecture includes:

  • An S3 bucket with EventBridge notifications enabled
  • An EventBridge rule that triggers Step Functions on S3 object creation
  • A Step Functions state machine with a Choice state for routing
  • A Lambda function for processing small files
  • An ECS Fargate task for processing large files
  • A VPC with two subnets, internet gateway, and security group
  • An ECR repository for the Fargate container image
  • Scoped IAM roles for Lambda, Step Functions, and ECS tasks
Installs
244
GitHub Stars
1.8K
First Seen
Jun 18, 2026
processing-s3-uploads-with-step-functions — aws/agent-toolkit-for-aws