Jammit S3 is a jammit wrapper that provides appropriate hooks so you can easily deploy your assets to s3/cloudfront
It's especially great for Heroku user who use generated assets such as coffee-script and sass. jammit-s3 includes a script you can use as a hook to recompile and upload all your assets.
To install jammit-s3, just use:
gem install jammit-s3
If you are using Rails3, add it to your project's Gemfile:
gem 'jammit-s3'
Jammit S3 already has a gem dependency for jammit, so I'd recommend removing any existing gem 'jammit' references from your Gemfile.
Within your config/assets.yml, just add a toplevel key called s3_bucket that contains the bucketname you want to use. If jammit-s3 doesn't find the bucket, it will try to create it. Bucketnames need to be globally unique. Learn more about bucketnames here
s3_bucket: my-awesome-jammit-bucket
To deploy your files to s3, just the jammit-s3 command at your project's root.
jammit-s3
If using it in the context of your Rails3 app, I'd recommend using bundle exec
bundle exec jammit-s3
Set your authenticaton information within config/assets.yml
s3_access_key_id: 03HDMNF59CWZ2J24T702
s3_secret_access_key: 1TzRlDmuH8DoOlJ2tlwW8qx+i+Pfe0jzIouWI2BL
Replace these with your own access keys, found here.
As you probably don't want to check this data into source control, I'd recommend you just set it to an environment variable on your local box, and use ERB
s3_access_key_id: <%= ENV['ACCESS_KEY_ID'] %>
s3_secret_access_key: <%= ENV['SECRET_ACCESS_KEY'] %>
You can then set these env variables in your .bash_profile
By default, jammit-s3 will upload your configured asset directly, along with public/images. However you can customize this using the s3_upload_files setting, which should be a list of file globs.
# adds image uploads
s3_upload_files:
- public/css/images/**
By default, jammit-s3 uses the permission setting found on the s3 bucket. However, you can override this with the config:
s3_permission: public_read
Valid permission options are:
private: Owner gets FULL_CONTROL. No one else has any access rights. This is the default.
public_read: Owner gets FULL_CONTROL and the anonymous principal is granted READ access. If this policy is used on an object, it can be read from a browser with no authentication.
public_read_write: Owner gets FULL_CONTROL, the anonymous principal is granted READ and WRITE access. This is a useful policy to apply to a bucket, if you intend for any anonymous user to PUT objects into the bucket.
authenticated_read: - Owner gets FULL_CONTROL, and any principal authenticated as a registered Amazon S3 user is granted READ access.
To use CloudFront, simply add your CloudFront domain to your environment specific asset host (i.e config/environments/production.rb):
config.action_controller.asset_host = "http://di8snu3y5lwja.cloudfront.net"
This will use the CloudFront domain name for your assets instead of serving them from the (slow) S3 bucket.
For this to work you need to make sure you have the CloudFront enabled via you Amazon acccount page. Go here: http://aws.amazon.com/cloudfront/ and click "Sign Up"
To avoid serving stale assets, especially when using CloudFront, you may also want to include a git commit hash in your asset path:
s3_include_abbrev_commit: on
At this point, since released files will never change, you can also set:
s3_cache_control: public,max-age=31536000
You will also need to override asset_path in config/environments/production.rb. If you're running on Heroku, you should be able to use the following:
config.action_controller.asset_path = lambda do |asset_path|
"/#{ENV['COMMIT_HASH']}#{asset_path}"
end
If you're using another deployment environment, you can get the commit hash using the following git command:
git rev-parse --short HEAD
To suggest a feature or report a bug: http://github.com/railsjedi/jammit-s3/issues/
Jammit S3 is a simple wrapper around Jammit. To view the original Jammit docs, use http://documentcloud.github.com/jammit/