Merge branch 'main' into dev

Author: Kanchan-Microsoft

docs/DeploymentGuide.md

@@ -435,6 +435,47 @@ When creating your environment name, follow these rules:
 2. **Add Authentication Provider**  
     - Follow steps in [App Authentication](./ConfigureAppAuthentication.md) to configure authentication in app service. Note that Authentication changes can take up to 10 minutes.  
 
+## Known Issues
+
+**Unable to update/add environment variables in Azure Container Apps**
+
+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.
+
 ## Deployment Success Validation
 
 After deployment completes, use this checklist to verify everything is working correctly: