Deploying Backstage

Heroku

Deploying to heroku is relatively easy following these steps.

First, make sure you have the heroku CLI installed and log into it as well as loging into Heroku's container registry.

$ heroku login
$ heroku container:login

You might also need to set your Heroku app's stack to container

$ heroku stack:set container -a <your-app>

There are two small tweaks made to Backstage's default Dockerfile to run on Heroku:

Do not run nginx as the nginx user.
Replace the standard port (80) in /etc/nginx/conf.d/default.conf with the wildcard $PORT, which Heroku will set for us.

These changes are in the deployment/Dockerfile.heroku file, which you will need to copy into your root directory before deploying:

$ cp deployment/Dockerfile.heroku Dockerfile

With these changes, we can build/push the Docker image to Heroku's container registry and release it to the web worker.

$ heroku container:push web -a <your-app>
$ heroku container:release web -a <your-app>

With that, you should have Backstage up and running!