Merge pull request #295 from microsoft/psl-add-known-issues

docs: add known issues section in deploymentGuide.md

Author: Roopan-Microsoft

docs/DeploymentGuide.md

@@ -257,3 +257,44 @@ To help you get started, here's the [Sample Workflow](./SampleWorkflow.md) you c
    provisioned using `azd provision` or `azd up`, a `.env` file is automatically generated in the `.azure/<env-name>/.env`
    file. To get your `<env-name>` run `azd env list` to see which env is default.
 5. Ensure that `APP_ENV` is set to "**dev**" in your `.env` file.
+
+## Known Issues
+
+**Unable to update/add environment variables in Azure Container App**
+
+You may encounter issues when attempting to modify environment variables or container configuration in Azure Container Apps:
+
+**Affected Scenarios:**
+- **App Authentication Setup:** When adding authentication-related environment variables (CRUD operations on env variables)
+- **Container Configuration:** When trying to edit ACR name, image, or tag information for Container Apps
+
+**Root Cause:**
+This is an ongoing issue in Azure that affects the Azure Portal's ability to update Container Apps configurations.
+
+**Workaround - Use Azure CLI:**
+
+Until this issue is resolved, use Azure CLI commands to add or update environment variables and container configurations:
+
+**For Environment Variables:**
+```bash
+# Update environment variables
+az containerapp update \
+  --name <container-app-name> \
+  --resource-group <resource-group-name> \
+  --set-env-vars "KEY1=value1" "KEY2=value2"
+```
+
+**For Container Image Updates:**
+```bash
+# Update container image
+az containerapp update \
+  --name <container-app-name> \
+  --resource-group <resource-group-name> \
+  --image <registry>/<image>:<tag>
+```
+
+📖 **Detailed CLI Documentation:**
+- [Manage environment variables](https://learn.microsoft.com/en-us/azure/container-apps/environment-variables?tabs=cli)
+- [Manage revisions](https://learn.microsoft.com/en-us/azure/container-apps/revisions-manage?tabs=bash)
+
+> **Note:** This is a temporary workaround. The documentation will be updated once the Azure Portal issue is resolved.