Skip to content

Buckets

Store objects in buckets. Expose public access through gateway.routes[] in stack.json.

Declare a bucket

Add an entry under resources.buckets[] in stack.json, then run kernstack deploy. See the IAC reference.

Seed data

Place seed objects under seed/buckets/{name}/ and omit seed from the bucket entry. The CLI uploads the directory after each successful deploy. Optional seed_prefix sets the object key prefix. Set seed explicitly when the directory lives elsewhere.

CLI

Operation Command
List buckets kernstack inspect buckets
List objects kernstack inspect buckets list bucket[/path]
Upload object kernstack inspect buckets put LOCAL bucket/path/key
Upload directory kernstack inspect buckets put-dir LOCAL_DIR bucket[/prefix]
Download object kernstack inspect buckets get bucket/path/key [-o PATH]
Delete object kernstack inspect buckets delete bucket/path/key
kernstack inspect buckets put ./photo.jpg uploads/images/photo.jpg
kernstack inspect buckets get uploads/images/photo.jpg -o ./photo.jpg
kernstack inspect buckets list uploads/images/