Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
86 lines (59 sloc) 3.11 KB

Asset ID – Asset stamping and uploading to S3 for Rails


Uploads static assets to Amazon S3 with unique identifiers encoded into the path of the asset.

Only works with Rails 3.x because Rails 3 makes doing this sort of thing a lot easier and
that is all I needed it for.

This library takes standard Rails asset paths such as /stylesheets/main.css?1288717704 and converts them

It uses an MD5 hash of the file contents to produce the id so the same asset will always have the same ID.

In my quest to achieve a Google Page Speed score of 100, this library achieves the following:

  • Assets served from a cookie-less domain
  • Unique identifier is not encoded into a query parameter (so it is cacheable by proxy servers)
  • All assets have far-future expires headers for caching
  • Assets have the Cache-Control: public header for caching
  • CSS and javascript is GZipped and the correct headers are added

As an added bonus, all your assets are available over https:// as well.


Add the gem to your Gemfile

gem "asset_id"

Configure config/environments/production.rb to use Amazon S3 as the asset host
and to use the id-stamped asset paths in helpers

config.action_controller.asset_host = do |source|
config.action_controller.asset_path = do |source|

Add your Amazon S3 configuration details to config/asset_id.yml

  access_key_id: 'MY_ACCESS_KEY'
  secret_access_key: 'MY_ACCESS_SECRET'
  bucket: "my_live_bucket"

Optionally create a rake task in lib/tasks/asset_id_tasks.rake to
perform the upload for use in your deploy scripts

namespace :asset do
  namespace :id do
    desc "uploads the current assets to s3 with stamped ids"
    task :upload do
      AWS::S3::DEFAULT_HOST.replace "" # If using EU bucket
      AssetID::Base.asset_paths += ['favicon.png'] # Configure additional asset paths

SSL configuration

If you want to use the SSL host in your configuration you can do so in config/environments/production.rb

config.action_controller.asset_host = do |source|
  request.ssl? '' : ''

Using Amazon CloudFront Content Delivery Network (CDN)

To use Amazon CloudFront as a CDN for your assets all you need to do is create a CloudFront distribution for the bucket you have defined your configuration and then substitute your unique CloudFront domain name in config/environments/production.rb

config.action_controller.asset_host = do |source|

SSL works fine here as well.