Put Your App Online With Heroku
Created by Terence Lee, @hone02
Follow steps “Introduction” and “Set up” of the Getting Started on Heroku with Ruby to sign up, install the Heroku CLI, and login.
COACH: Talk about the benefits of deploying to Heroku vs traditional servers.
Preparing your app
Version Control Systems
We need to add our code to version control. You can do this by running the following in the terminal:
COACH: This would be a good time to talk about version control systems and git.
Updating our database
First, we need to get our database to work on Heroku, which uses a different database. Please change the following in the Gemfile:
bundle install --without production to setup your dependencies.
Next, update the
Change the following in the file:
Don’t forget to do
git add . and
git commit -m "Use postgres as production database"
in order to add this change to your master branch before pushing to heroku later.
COACH: You can talk about RDBMS and the different ones out there, plus include some details on Heroku’s dependency on PostgreSQL.
Deploying your app
We need to create our Heroku app by typing
heroku create in the terminal and
see something like this:
In this case “young-reaches-87845” is your app name.
Pushing the code
Next we need to push our code to heroku by typing
git push heroku master.
You’ll see push output like the following:
You’ll know the app is done being pushed, when you see the “Launching…” text like above.
Next we need to migrate our database like we did locally during the workshop:
When that command is finished being run, you can hit the app based on the url.
For this example app, you can go to https://young-reaches-87845.herokuapp.com/.
You can also type
heroku open in the terminal to visit the page.
Heroku’s platform is not without its quirks. Applications run on Heroku live within an ephermeral environment — this means that (except for information stored in your database) any files created by your application will disappear if it restarts (for example, when you push a new version).
Each dyno gets its own ephemeral filesystem, with a fresh copy of the most recently deployed code. During the dyno’s lifetime its running processes can use the filesystem as a temporary scratchpad, but no files that are written are visible to processes in any other dyno and any files written will be discarded the moment the dyno is stopped or restarted. For example, this occurs any time a dyno is replaced due to application deployment and approximately once a day as part of normal dyno management.
In the App tutorial the ability to attach a file to the Idea record is
added, which results in new files being written to your applications
public/uploads folder. The ephemeral storage in Heroku can be seen with the
- Launch the app with
- Add a new Idea with an image
- Restart the application by running
- Go back to your Idea and reload the page - the image should no longer be visible
Working around Ephemeral Storage
Obviously this doesn’t seem to be useful if you were running a real life application, but there are ways to work around this which is commonly used by a lot of popular websites.
The most common method is to use an external asset host such as Amazon S3 (Simple Storage Service) or Rackspace CloudFiles. These services provide (for a low cost
- usually less then $0.10 per GB) storage ‘in the cloud’ (meaning the files could potentially be hosted anywhere) which your application can use as persistent storage.
While this functionality is a bit out of scope for this tutorial there are some resources available which you can use to find your way:
As always if you require any more information or assistance your coaches will be able to assist.
- Handy cheatsheet for Ruby, Rails, console etc.
- Guide 1: Guide to install Rails
- Guide 2: Build Your First App
- Guide 3: Push Your App to GitHub
- Guide 4: Put your app online with…
- Guide 5: Allow Comments on Your App
- Guide 6: Add design using HTML & CSS
- Guide 7: Create thumbnails with Carrierwave
- Guide 8: Add Authentication (user accounts) with Devise
- Guide 9: Add Profile Pics with Gravatar
- Guide 10: Improve your design with HTML and CSS
- Guide 11: Continuous Deployment
- Guide 12: Build a voting app in Sinatra
- Guide 13: Build a diary app in Ruby on Rails
- Guide 14: Add a back-end to your app (admin pages)
- Guide 15: Go through additional explanations for the App