feat: update backup and restore procedure for graphdb

Updates backup procedure to include instructions for using BAAS Console.

Author: Jwilson2000

content/latest/deploy/backup/graphdb.md

@@ -22,13 +22,11 @@ Before you start, ensure you have the following:
 {{% param pre_reqs %}}.
 
 
-Before you start, confirm you are in the right context and namespace:
+Before you start, you will need to do the following:
 
-{{% param "k8s_cluster_ns" %}}
-
-## Steps
+1. Confirm you are in the right context and namespace:
 
-To back up the database, follow these steps:
+{{% param "k8s_cluster_ns" %}}
 
 1. Check the logs for the alpha and zero pods, either in Lens or with [`kubectl logs`](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#logs).
     Ensure there are no errors.
@@ -46,6 +44,36 @@ To back up the database, follow these steps:
 
     For details, read the Kubernetes topic [Get Shell to a Running Container](https://kubernetes.io/docs/tasks/debug/debug-application/get-shell-running-container/).
 
+## Steps
+
+To back up the database, you will need to first trigger a backup, and then retrieve the backup using `kubectl`.
+
+### Backup
+
+To back up the database, you can use either of the following methods:
+
+#### BAAS Console
+
+This method will use BAAS's web console to trigger a backup.
+
+1. Navigate to `<baas-url>/console` in your browser of choice.
+
+1. Login to the BAAS Console with your Keycloak credentials.
+
+1. Click "Backups" > "Local Export".
+
+{{< callout type="info" >}}
+Database backups support S3/Minio and includes an option to list backups in a specific destination. For this guide we will be performing a local backup.
+{{< /callout >}}
+
+1. Enter your designated backup location along with the backup name, or use the default provided.
+
+1. Click "Start Export" and wait for the operation to finish. A dialogue should appear saying "Export Completed Successfully".
+
+#### Alpha Pod Shell
+
+This option will use the shell opened in the prerequisites to trigger a backup.
+
 1. Make a POST request to your Keycloak `/token` endpoint to get an `access_token` value.
 For example, with `curl` and `jq`:
 
@@ -73,6 +101,10 @@ For example, with `curl`:
     --data-raw '{"query":"mutation {\r\n export(input: {format: \"json\", destination: \"/dgraph/backups/'"$(date +"%Y-%m-%dT%H.%M.%SZ")"'\"}) {\r\n response {\r\n message\r\n code\r\n }\r\n}\r\n}","variables":{}}'
     ```
 
+### Retrieve
+
+To retrieve the backup, we will need to use the alpha pod shell opened in the prerequisites.
+
 1. Change to the backup directory (the `destination` parameter in the preceding `curl` command). For example:
 
     ```bash

content/latest/deploy/restore/graphdb.md

@@ -97,44 +97,6 @@ Before you start, ensure you have the following:
 
 1. Wait for `{{< param application_name >}}-baas-alpha-0` to start serving the GraphQL API.
 
-1. Make a database mutation to force a snapshot to be taken.
-For example, create a `UnitOfMeasure` then delete it:
+1. Repeat the process, starting from step 4, for each Alpha replica.
 
-    ```bash
-    kubectl exec -t {{< param application_name >}}-baas-alpha-0 -c {{< param application_name >}}-baas-alpha -- \
-    curl --location --request POST 'http://localhost:8080/graphql' \
-    --header 'Content-Type: application/json' \
-    --data-raw '{"query":"mutation RestoringDatabase($input:[AddUnitOfMeasureInput!]!){\r\n addUnitOfMeasure(input:$input){\r\n unitOfMeasure{\r\n id\r\n dataType\r\n code\r\n }\r\n}\r\n}","variables":{"input":[{"code":"Restoring","isActive":true,"dataType":"BOOL"}]}}'
-    ```
-    Wait until you see {{< param application_name >}}-baas creating a snapshot in the logs. For example:
-
-    ```bash
-    $ kubectl logs {{< param application_name >}}-baas-alpha-0
-    ++ hostname -f
-    ++ awk '{gsub(/\.$/,""); print $0}'
-    ...
-    I0314 20:32:21.282271 19 draft.go:805] Creating snapshot at Index: 16, ReadTs: 9
-    ```
-
-    Revert any database mutations:
-
-    ```bash
-    kubectl exec -t {{< param application_name >}}-baas-alpha-0 -c {{< param application_name >}}-baas-alpha -- \
-    curl --location --request POST 'http://localhost:8080/graphql' \
-    --header 'Content-Type: application/json' \
-    --data-raw '{"query":"mutation {\r\n deleteUnitOfMeasure(filter:{code:{eq:\"Restoring\"}}){\r\n unitOfMeasure{\r\n id\r\n }\r\n }\r\n}","variables":{"input":[{"code":"Restoring","isActive":true,"dataType":"BOOL"}]}}'
-    ```
-
-1. Complete the initialization container for alpha 1:
-
-    ```bash
-    kubectl exec -t {{< param application_name >}}-baas-alpha-1 -c {{< param application_name >}}-baas-alpha-init -- \
-    touch /dgraph/doneinit
-    ```
-
-    And alpha 2:
-
-    ```bash
-    kubectl exec -t {{< param application_name >}}-baas-alpha-2 -c {{< param application_name >}}-baas-alpha-init -- \
-    touch /dgraph/doneinit
-    ```
+    In each step replace `{{< param application_name >}}-baas-alpha-0` with `{{< param application_name >}}-baas-alpha-<REPLICA-NUMBER>`, where `<REPLICA-NUMBER>` is the current Alpha replica being restored.