From 024b8bceee2ac5500a695546c1e6acb3a4dacb42 Mon Sep 17 00:00:00 2001
From: Martina Iglesias Fernandez <martina@roadie.io>
Date: Mon, 5 Oct 2020 17:29:32 +0200
Subject: [PATCH] Add docs

---
 contrib/chart/backstage/README.md | 42 ++++++++++++++++++++++++-------
 1 file changed, 33 insertions(+), 9 deletions(-)

diff --git a/contrib/chart/backstage/README.md b/contrib/chart/backstage/README.md
index bccc934da8..51f0bb0d7c 100644
--- a/contrib/chart/backstage/README.md
+++ b/contrib/chart/backstage/README.md
@@ -35,27 +35,51 @@ backstage-ingress   *       34.77.171.192   80      17m
 
 ## Customization
 
-Configuring a connection to an existing PostgreSQL instance is possible through the chart's values:
+Configuring a connection to an existing PostgreSQL instance is possible through the chart's values.
+
+First create a yaml file with the configuration you want to override, for example `backstage-prod.yaml`:
 
 ```bash
+postgresql:
+  enabled: false
+
 appConfig:
+  app:
+    baseUrl: https://backstage-demo.mydomain.com
+    title: Backstage
   backend:
+    baseUrl: https://backstage-demo.mydomain.com
+    cors:
+      origin: https://backstage-demo.mydomain.com
     database:
       client: pg
       connection:
         database: backstage_plugin_catalog
         host: <host>
-        user: <user>
-        port: <port>
+        user: <pg user>
         password: <password>
-        ssl:
-          rejectUnauthorized: true
-```
-
-For the CA, create a `configMap` named `ca.crt`:
+lighthouse:
+  database:
+    client: pg
+    connection:
+      host: <host>
+      user: <pg user>
+      password: <password>
+      database: lighthouse_audit_service
 
 ```
-kubectl create configmap %s --from-file=ca.crt"
+
+For the CA, create a `configMap` named `<helm_release_name>-postgres-ca` with a file called `ca.crt`:
+
+```
+kubectl create configmap my-backstage --from-file=ca.crt"
+```
+
+Now install the helm chart:
+
+```
+cd contrib/chart/backstage
+helm install -f backstage-prod.yaml my-backstage .
 ```
 
 ## Troubleshooting