using-localstack

# Mastering LocalStack Pro — Practitioner Skill

Operations-first playbook to emulate AWS locally with high fidelity. Focuses on production-parity workflows (event-driven, streaming, containers, IaC), fast debugging, and deterministic CI.

## Audience & Outcomes
- For senior backend/platform/DevOps/AI-data engineers needing production-parity local AWS for event-driven, streaming, and data/agentic workloads
- Assumes AWS fluency; focuses on emulator fidelity vs AWS deltas
- Outcomes: spin up complex stacks locally (EKS/MSK/Aurora/Step Functions), debug IAM/networking/event flows, run deterministic CI/CD

## When to Use
- Stand up AWS stacks locally (S3, Lambda, DynamoDB, API Gateway, EventBridge, MSK, EKS, RDS/Aurora, Step Functions)
- Build deterministic CI/CD without hitting real AWS
- Debug IAM, networking, events, or data flows offline before deploying to AWS

## When Not to Use
- Production deployments (LocalStack is for dev/test only)
- Multi-region/global table testing (single-region emulation)
- Performance/scale validation (no multi-AZ, different latency profile)
- Managed service edge cases (simplified IAM enforcement, custom resources may differ)

## Community vs Pro
- **Community:** core services (S3, basic Dynamo, Lambda, API GW) for simple serverless
- **Pro:** advanced services and fidelity (MSK/Kinesis+Pipes, EKS/ECS/Fargate, Aurora/RDS, Step Functions with mocking/visualization, EventBridge schema/pipes, IAM enforcement/Policy Stream, Cloud Pods, offline bundles)

Use Pro when avoiding deploy-to-test cycles outweighs license cost.

## Quick Start
1. **Install:** `pipx install localstack` (recommended: isolated Python env, cross-platform) OR `brew install localstack/tap/localstack-cli` (macOS-only, simpler on M1/M2)

2. **Start:**  
   - Community: `localstack start -d`  
   - Pro: `LOCALSTACK_AUTH_TOKEN=<token> localstack start -d --version x.y.z`

3. **Health check:** `curl http://localhost:4566/_localstack/health | jq`  
   **Verify:** All needed s