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