When it comes to deploying an application, there are usually two options: a VPS or a PaaS (platform as a service). This article will show you a recipe for deploying an application to production on a PaaS like Heroku.
Step 1 - Create the project
The first step is to create a simple structure for our project with some basic files. For this article, I’ll create a demo server with NodeJS.
In a new folder I’ll open a terminal and run the command
npm init -y in order to create a new project. The dummy server will be written in Express, so we need to run the
npm install express command to install this module.
Once this library is installed, we can create a new file for our project, named
app.js. Inside it we'll write the code for our simple server:
We can start the application by running
node app.js. Then we can try it out at the following URL
http://localhost:3000. At this point you should see the message
Hello World in the browser.
Step 2 - Version control system
The next step is to choose a version control system and to place our code in a development platform in a repository.
On GitHub, go ahead and create a new repository for your application, like this:
To upload your local code into a repository, you need to run the commands that are listed on Github after you click
Create repository button:
! Before we do this, we must ignore some files. We want to upload to the repository only the code that we write, without the dependencies (the installed modules).
For that, we need to create a new file
.gitignore and inside it write the file that we want to ignore.
Now, we can write the commands listed in the picture above (the one from GitHub).
If you ran the commands correctly, then it'll be on your repository’s page. If you refresh it you should see your files, except the one that you explicitly ignored, namely
Step 3 - Link the repository with Heroku
At this step, we can link the repository from Github to our Heroku application.
First, create a new application on Heroku and follow the steps listed on the platform.
Once the application has been created, a window similar to this should appear:
Now, if you look at the navigation at the top, you'll see
Metrics and so on. Be sure that
Deploy is selected. Then on the second row, click on the GitHub icon.
Search for the desired application, which is
demo-deploy-app-09 in our case. Then click
Once the application is successfully connected with your Heroku account, you can click
Deploy Branch to deploy your application.
If you want, you can also select the option
Enable Automatic Deploys which will automatically pull the code from your Github repository every time you make a push to that repository.
Once the application has been deployed, you can click on View to open your application.
Step 4 - Configure Heroku to properly run the application
If you open the application at this point, you should see something like this:
That’s right, an error. That’s because Heroku doesn’t know how to start our application.
If you remember, we ran the command
node app.js to start the application locally.
Heroku has no way of knowing what commands it needs to run to start the application, and that's why it threw an error.
To solve this problem, we must create a new file named
Procfile with the following content:
web: node ./app.js.
To update our application, all we need to do is push a new commit to GitHub. If we have enabled the
Automatic Deploys option, then the code will be automatically pulled to Heroku. Otherwise we need to click on
Deploy Branch again.
Once the application is rebuilt, we should see it working like so:
Step 5 - How to add an add-on
One key benefit that Heroku provides is the fact that you can easily add resources in the form of
add-ons to your project. These external resources come in the form of databases, logging & monitoring tools, CI and CD tools, or testing tools.
So now let's see how to add a new resource to your project. First, we'll go to Resources, and from there we'll add a new tool for testing.
Go ahead and click on
Find more add-ons and then search for
Loadmill is a testing tool which is really great for regression testing and load testing.
Go ahead and click on
Install…. Then choose the application you want to link.
At this step, Heroku will automatically create a new account for you on the provisioned platform.
On the resources tab, you can see the newly added resource:
If you go ahead and access this add-on, you should see its dashboard with an intro tutorial and a demo test created for you.
Heroku allows developers to quickly and almost painlessly deploy an application on a web server.
It also provides a lot of plugins that you can integrate into your application.
A PaaS solution will always allow you to move faster than the solution with a VPS where you have to configure everything from the ground up.