This is an extension for Spree, allowing the e-commerce system to run on Heroku - http://heroku.com.
The major constraint on Heroku is that we can't write files to disk, so this extension disables all disk caching, fixes a few issues and changes Spree to store on Amazon S3.
A Heroku account and an Amazon S3 account with a bucket.
Make a Spree application:
Install this extension:
cd myapp script/extension install git://github.com/RSpace/spree-heroku.git
Copy the .gems manifest to the root of your application:
cp vendor/extensions/heroku/.gems ./
Configure the extension with your S3 information.
You can either specify the S3 credentials via Heroku's environment variables (recommended):
heroku config:add S3_KEY=[your S3 key] heroku config:add S3_SECRET=[your S3 secret] heroku config:add S3_BUCKET=[your S3 bucket]
- or you can use a YAML file:
cp vendor/extensions/heroku/config/aws_s3.yml.example vendor/extensions/heroku/config/aws_s3.yml
Enter your S3 configuration to vendor/extensions/heroku/config/aws_s3.yml
Create a Heroku application and deploy it:
git init git add . git commit -m 'Initial create' heroku create --stack bamboo-ree-1.8.7 myapp git push heroku master
Enable SSL, since Spree uses SSL for administration and payment flow in its standard setup:
heroku addons:add "Piggyback SSL"
Bootstrap the database locally (not possible in Heroku, because the rake task attempts to copy files), and transfer it to Heroku:
rake db:bootstrap heroku db:push
Please note that if you choose to load sample data, images will be missing for all products. Spree's bootstrap task copies the images locally, but it doesn't put them on S3, where this extension configures Spree to look for images.
That's it - you're done! :)
This extension has been tested with Spree 0.10.2. If you have problems using the extension with a newer version of Spree, it could be due to Spree's gem dependencies having changed. The gems in the heroku .gems manifest must mach the gems and versions required by Spree. This page shows the current dependencies of the newest version of Spree: http://gemcutter.org/gems/spree
Copyright (c) 2009 Casper Fabricius, released under the MIT license
- Pavel Chipiga
- Andrey Voronkov