add the known issues readme (#33)

Author: nickdala

docs/assets/az-webapp-deploy-error-second-region.png

@@ -0,0 +1,10 @@
+# Known issues
+This document helps with troubleshooting and provides an introduction to the most requested features, gotchas, and questions.
+
+## Deploying the app to the second region
+
+The production deployment calls for the app to be deployed to two regions. The azure cli command `az webapp deploy` does not honor the `--restart false` flag. The app will fail to be restarted after deployment because the database is not yet configured to use the secondary region.
+
+Below is the error that you may see after deploying the app to the second region:
+
+![az webapp deploy error](./docs/assets/az-webapp-deploy-error-second-region.png)

known-issues.md

@@ -338,10 +338,12 @@ We will now configure the Contoso Fiber application to use Microsoft Entra authe
     az webapp deploy --resource-group $primary_spoke_resource_group --name $primary_app_service_name --src-path cams.jar --type jar
     ```
 
-1. Deploy the application to the secondary region using:
+1. Deploy the application to the secondary region using the following command. 
+
+    This step is optional and can be done at a later time. There is a known issue with the deployment of the secondary region. See [known_issues](./known-issues.md) for more information.
 
     ```shell
-    az webapp deploy --resource-group $secondary_spoke_resource_group --name $secondary_app_service_name --src-path cams.jar --type jar --restart false --async true
+    az webapp deploy --resource-group $secondary_spoke_resource_group --name $secondary_app_service_name --src-path cams.jar --type jar --restart false
     ```
 
     The `--restart false` flag is used to prevent the app from restarting after deployment. This is because the app is not yet configured to use the database as the secondary region is on stand by.
@@ -433,6 +435,24 @@ We will now configure the Contoso Fiber application to use Microsoft Entra authe
     az containerapp update -n email-processor -g $secondary_spoke_resource_group --image $email_processor_image
     ```
 
+    Ensure that the image is updated in the container app.
+
+    ```shell
+    az containerapp show -n email-processor -g $primary_spoke_resource_group --query "properties.template.containers[0].image" -o tsv
+    ```
+
+    ```shell
+    az containerapp show -n email-processor -g $secondary_spoke_resource_group --query "properties.template.containers[0].image" -o tsv
+    ```
+
+    If the image is not updated, issue the update command again.
+
+    ```shell
+    az containerapp update -n email-processor -g $primary_spoke_resource_group --image $email_processor_image
+
+    az containerapp update -n email-processor -g $secondary_spoke_resource_group --image $email_processor_image
+    ```
+
 1. Exit the jumpbox using:
 
     ```shell