This tutorial show you how to deploy your Rails application with PostgreSQL database. Let's go!

Before you begin, this guide assumes the following:

• Your Operating System is macOS / Windows / Linux
• You have a Github, Gitlab or Bitbucket account

➡️. Do you migrate from Heroku to AWS? Read this tutorial ⬅️

Steps to deploy Rails with Qovery

• Web
• CLI

Sign in to the Qovery web interface.

Rails application

Rails sample application

Get a copy of the sample source code of Rails sample project by forking it.

To deploy your Rails application connected to a PostgreSQL, you can use our sample code and follow the configuration steps.

In this example we are using PostgreSQL v11.5.

1. Create a new project

   

2. Create a new environment

   

3. Create a new application

   To follow the guide, you can fork and use our repository

   Use the forked repository (and branch master) while creating the application in the repository field:

   

4. Select application port

   After the application is created:

   • Navigate application settings
   • Select Port
   • Add port 3000

   

5. Use Dockerfile

   In the settings General section, set Build Mode to Dockerfile and set Dockerfile path as "Dockerfile". Then save your change.

How was it? Did this tutorial work?  Yes  No

PostgreSQL

1. Deploy a PostgreSQL database

   In your environment view, click on Add and Database buttons:

   

   In the popup window while adding a database, choose your name, select PostgreSQL and 11.5 version.

   

   In the end, click on your added database - in the new screen you'll be able to find the Deploy button:

   

   To learn how to add a PostgreSQL database in more details, you can follow this guide.

2. Connect your Rails application to PostgreSQL

   Credentials of your PostgreSQL database are available via Environment Variables and Secrets. Qovery injects environment vars at the runtime.

   You can learn more about environment variables and secrets here.

   To list all the environment variables available to your Rails application, you can open Environment Variables and Secret tabs in your application window:

   

   In the Secrets section, you'll see all names of injected database secrets, including those for the previously created PostgreSQL database. To connect the Rails app to the PostgreSQL database, you need to setup the application to use those secrets.

   All you have to do is to open and edit database configuration file in your forked repository. Replace all the QOVERY_DATABASE_XXX variables with values you have in your own environment. Those variable keys contain your database ID, this is why you need to update the file.

   TIP: you could also make use of Variable Aliases to change the name of used environment variables in your Rails application. Learn more here.

How was it? Did this tutorial work?  Yes  No

Deploy your application

All you have to do now is to navigate to your application and click Deploy button

That's it. Watch the status and wait till the app is deployed.

Congratulations! Your environment with Rails application and PostgreSQL database should be in progress.

Trigger a new deployment

Now, you can play with the sample Rails application and commit & push your changes. Qovery detects your actions and triggers new builds and application deployments. Any change you make will be reflected in your deployed application automatically.

Conclusion

Congratulations! Now, you know how to deploy your Rails app with PostgreSQL in just a few steps.

Do you have any feedback about this tutorial? Let us know what you think on Discord, and join our wonderful dev community of +5500 devs.

Tutorial