page:guides:sinatra:cdn assets

Deliver public assets through CDN for Sinatra

Summary: Cdn assets for a Sinatra app on Ample. Verified on Sinatra: a versioned, immutable-cached asset uploaded to a published bucket and served from the CDN URL. Build and start: bundle install into vendor/bundle from Gemfile.lock (development and test groups skipped), then Puma via rackup (config.ru) reading PORT on the ruby-3.4 template.

Representative Queries

Resource Requirements

Prerequisites

  1. A Sinatra project (bundle install into vendor/bundle from Gemfile.lock (development and test groups skipped), then Puma via rackup (config.ru) reading PORT on the ruby-3.4 template).
  2. A bucket from ample bucket create with credentials passed as encrypted S3_* environment variables.
  3. An Ample account token with servers:write, buckets:read.

Workflow Steps

  1. Build and start: bundle install into vendor/bundle from Gemfile.lock (development and test groups skipped), then Puma via rackup (config.ru) reading PORT on the ruby-3.4 template; the server must bind 0.0.0.0 on PORT.
  2. Publish a bucket for public assets: Publish only the asset bucket; upload versioned keys with an immutable Cache-Control header and build URLs from its public URL. Command: ample bucket publish
  3. Verify: Fetch the live URL and /p/versioned-static-assets on the example; on failure read the build and runtime logs. Command: ample logs --kind build

Examples

Success Checks

Limitations

Cost Estimate

Last Verified At

2026-09-20T23:45:31Z

Formats

Next Actions