Local AWS Emulator for 37 Services with a 2.2 MiB Footprint

jobs:
  integration-test:
    runs-on: ubuntu-latest
    env:
      AWS_ENDPOINT_URL: http://localhost:4566
      AWS_ACCESS_KEY_ID: test
      AWS_SECRET_ACCESS_KEY: test
      AWS_DEFAULT_REGION: us-east-1
    steps:
      - uses: actions/checkout@v4

      - name: Start RustStack static binary
        run: |
          curl -fsSL https://github.com/ehlerst/ruststack/releases/latest/download/ruststack-x86_64-unknown-linux-musl.tar.gz \
            | sudo tar xz -C /usr/local/bin
          ruststack start --port 4566 &
          for i in $(seq 1 20); do
            curl -sf http://localhost:4566/_ruststack/health && break
            sleep 0.1
          done

      - name: Run test suite
        run: cargo test

# 1. Start RustStack container (or run static binary `ruststack start --port 4566`)
docker run -d --name ruststack -p 4566:4566 ehlers320/ruststack:latest

# 2. Point AWS CLI & SDKs at localhost:4566
export AWS_ENDPOINT_URL=http://localhost:4566
export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test
export AWS_DEFAULT_REGION=us-east-1

# 3. Use S3, DynamoDB, SQS, KMS, Secrets Manager immediately
aws s3 mb s3://my-bucket
aws s3 cp README.md s3://my-bucket/README.md
aws sqs create-queue --queue-name orders-queue
aws dynamodb list-tables

# 4. Open Embedded Dark-Mode Web Admin UI
open http://localhost:4566/_ruststack/ui/

# Python Testcontainers + boto3
import boto3
from testcontainers.core.container import DockerContainer
from testcontainers.core.waiting_utils import wait_for_logs

with DockerContainer("ehlers320/ruststack:latest").with_exposed_ports(4566) as container:
    endpoint = f"http://{container.get_container_host_ip()}:{container.get_exposed_port(4566)}"
    s3 = boto3.client(
        "s3",
        endpoint_url=endpoint,
        aws_access_key_id="test",
        aws_secret_access_key="test",
        region_name="us-east-1",
    )
    s3.create_bucket(Bucket="test-bucket")

# Atomically reset all 37 services (or specific services) between tests in <1ms
curl -X POST http://localhost:4566/_ruststack/state/reset \
  -H "Content-Type: application/json" \
  -d '{"services": ["s3", "dynamodb", "sqs"]}'

# Export / Restore full cluster state snapshot
curl http://localhost:4566/_ruststack/state/dump > cluster-snapshot.json
curl -X POST http://localhost:4566/_ruststack/state/load -d @cluster-snapshot.json

# Inject 50% DynamoDB ProvisionedThroughputExceededException to test SDK retry backoff
curl -X POST http://localhost:4566/_ruststack/chaos/rules \
  -H "Content-Type: application/json" \
  -d '{
    "service": "dynamodb",
    "action": "PutItem",
    "probability": 0.5,
    "error_status": 400,
    "error_code": "ProvisionedThroughputExceededException"
  }'