S3
Quick Reference
# List buckets
aws s3 ls
# List contents of a bucket
aws s3 ls s3://staging-ecom-product-data-bucket/
# Check bucket exists
aws s3api head-bucket --bucket staging-ecom-product-data-bucket
# Get an object
aws s3 cp s3://staging-cloud-controller/feature_flags.json -
# Check object metadata
aws s3api head-object --bucket staging-console-static --key html/index.html
Key Buckets
| Bucket Pattern | Purpose | Used By |
|---|---|---|
{env}-ecom-product-data-bucket | Product data before indexing | Ecom indexer, Shopify admin, webhook worker |
{env}-shopify-app-assets | Shopify admin UI + storefront widget | Ecom API Gateway (public, web-hosted) |
{env}-console-static | Console React frontend assets | Console API Gateway (S3 integration) |
{env}-cloud-controller | EBS app versions + feature flags | Controller EBS, auth Lambda, admin Lambda |
Feature Flags
Static feature flags are stored as JSON in the controller bucket:
aws s3 cp s3://staging-cloud-controller/feature_flags.json - | python3 -m json.tool
Read by admin Lambda and auth Lambda at startup.
What to Look For
| Symptom | Check |
|---|---|
| Console not loading | Check {env}-console-static bucket has html/index.html |
| Shopify assets missing | Check {env}-shopify-app-assets bucket, verify public access |
| Product data issues | List objects in {env}-ecom-product-data-bucket for the shop |
| Feature flag not applying | Read feature_flags.json from controller bucket |