paint-brush
How To Connect Ruby on Rails API, PostgreSQL And Herokuby@ermin
792 reads
792 reads

How To Connect Ruby on Rails API, PostgreSQL And Heroku

by Ermin CahtarevicSeptember 7th, 2020
Read on Terminal Reader
Read this story w/o Javascript
tldt arrow

Too Long; Didn't Read

How To Connect Ruby on Ruby on Rails API, Postgres And Heroku? Read this article by Ermin Cahtarevic. Create a new Ruby app with Postgresql as the database for your API. Use the Heroku API to deploy your app to Heroku platform. Use Heroku to create a GitHub repository for your app and create a new Heroku app. Use GitHub to store your code and store it on your GitHub repository. Run the following commands in your terminal to deploy the Ruby on rails API. The API is now live and Heroku is deployed.

Companies Mentioned

Mention Thumbnail
Mention Thumbnail
featured image - How To Connect Ruby on Rails API, PostgreSQL And Heroku
Ermin Cahtarevic HackerNoon profile picture

Creating a new Rails app is super easy by itself. And, creating a Rails app set up as an API is not much different.

Because we are planning on deploying our app to Heroku we need to set it up with PostgreSQL as the database.

The default database in Rails is SQLite, but it is not supported by Heroku

Let’s start!

1) Make sure your Rails version is up to date

Run the following line in your terminal to update Rails

gem update rails

and then this line to get the current version of Rails

rails -v

2) Create the Rails API with PostgreSQL

rails new <<APP_NAME>> --api --database=postgresql
Replace the 
<<APP_NAME>>
 with the actual name of your app
  • rails new  create a new Rails app
  • - -api — initialize the new app as an API. This means the newly created app will not have any views. And the ApplicationController will inherit from ActionController::API instead of ActionController::Base
  • -- database=postgresql — And, as you can probably guess, this last part sets up the app to use PostgreSQL as the database

3) Create a new GitHub repository for your app

Keep track of the development of your API by storing your code on GitHub.

Check this link to see how to add an existing project to a Github repository.

4) Sign up for free on Heroku

Follow this link to the Heroku Sign up page.

5) Install Heroku CLI

Next, we will need to install the Heroku CLI to be able to deploy our little project.

Check this link to see how to install the Heroku CLI.

Once installed the

heroku
command is available from your terminal.

6) Log in using your Heroku account details

Run the following command in your terminal and enter your Heroku credentials when prompted

heroku login
Press Enter at the prompt to upload your existing ssh key or create a new one, used for pushing code later on

7) Create a new Heroku app

Run the following command in your terminal to create a new app on Heroku

heroku create

After that, we are all set up to deploy our app to Heroku!

8) Deploy the project

We are finally here!

Run the following commands in your terminal to deploy your app to Heroku

git add .
git commit -m "Deploy my super awesome Rails API"

git push heroku master

Side note — if you are working on a different branch from the master branch. You can run the following command to deploy your code

For example, if you are working on the 

feature-branch

git push heroku feature-branch:master

9) Our app is deployed!

That’s it, our Rails API is now live!

It’s an API-only application, it’s using PostgreSQL as the database and it’s deployed to Heroku.

Congratulate yourself. And then, get back to work, you have only begun.

Thanks for reading. And hopefully, this article helps you out.