From e80a94f5c31aad63840c36bf592a072310d787c2 Mon Sep 17 00:00:00 2001
From: Chap Ambrose <cambrose@salesforce.com>
Date: Mon, 8 Jul 2024 09:50:17 -0500
Subject: [PATCH] add docker instructions to heroku.md

Signed-off-by: Chap Ambrose <cambrose@salesforce.com>
---
 docs/deployment/heroku.md | 36 +++++++++++++++++++++++++++++++++---
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/docs/deployment/heroku.md b/docs/deployment/heroku.md
index 9629dbb212..8f173578c5 100644
--- a/docs/deployment/heroku.md
+++ b/docs/deployment/heroku.md
@@ -46,14 +46,14 @@ backend:
 Add a build script in `package.json` to compile frontend during deployment:
 ```json
 "scripts": {
-  "build": "yarn build:backend --config ../../app-config.yaml --config app-config.production.yaml"
+  "build": "yarn build:backend --config ../../app-config.yaml --config ../../app-config.production.yaml"
 ```
 
 ## Start Command
 
 Create a [Procfile](https://devcenter.heroku.com/articles/procfile) in the app's root:
 ```shell
-$ echo "web: yarn workspace backend start --config ../../app-config.yaml" > Procfile
+$ echo "web: yarn workspace backend start --config ../../app-config.yaml --config ../../app-config.production.yaml" > Procfile
 ```
 
 ## Database
@@ -63,7 +63,7 @@ Provision a [Heroku Postgres](https://elements.heroku.com/addons/heroku-postgres
 $ heroku addons:create heroku-postgresql -a <your-app>
 ```
 
-Update `database` in `app-config.yaml`:
+Update `database` in `app-config.production.yaml`:
 ```yaml
 backend:
   database:
@@ -99,3 +99,33 @@ View logs:
 ```shell
 $ heroku heroku -a <your-app>
 ```
+
+## Docker
+
+As an alternative to git deploys, Heroku also [supports container images](https://devcenter.heroku.com/articles/container-registry-and-runtime).
+
+Login to Heroku's container registry:
+
+```shell
+$ heroku container:login
+```
+
+Configure the Heroku app to run a container image:
+
+```shell
+$ heroku stack:set container -a <your-app>
+```
+
+Locally run the [host build command](https://backstage.io/docs/deployment/docker/#host-build):
+```shell
+$ yarn build:backend --config ../../app-config.yaml --config ../../app-config.production.yaml
+```
+
+Build, push, and release the container image:
+```shell
+$ docker image build . -f packages/backend/Dockerfile --tag registry.heroku.com/<your-app>/web
+
+$ docker push registry.heroku.com/<your-app>/web
+
+$ heroku container:release web -a <your-app>
+```