Refactor process_sample_data.sh to streamline required variable retrieval (#725)

Author: Harsh-Microsoft

azure.yaml

@@ -16,7 +16,7 @@ hooks:
         Write-Host "Web app URL: "
         Write-Host "$env:WEB_APP_URL" -ForegroundColor Cyan
         Write-Host "`nRun the following command in your Bash terminal. It will grant the necessary permissions between resources and your user account, and also process and load the sample data into the application."
-        Write-Host "bash ./infra/scripts/process_sample_data.sh $env:AZURE_RESOURCE_GROUP" -ForegroundColor Cyan
+        Write-Host "bash ./infra/scripts/process_sample_data.sh" -ForegroundColor Cyan
       shell: pwsh
       continueOnError: false
       interactive: true
@@ -26,7 +26,7 @@ hooks:
         echo $WEB_APP_URL
         echo ""
         echo "Run the following command in your Bash terminal. It will grant the necessary permissions between resources and your user account, and also process and load the sample data into the application."
-        echo "bash ./infra/scripts/process_sample_data.sh $env:AZURE_RESOURCE_GROUP"
+        echo "bash ./infra/scripts/process_sample_data.sh"
       shell: sh
       continueOnError: false
       interactive: true

docs/AVMPostDeploymentGuide.md

@@ -1,30 +1,51 @@
 # AVM Post Deployment Guide
+
+> **📋 Note**: This guide is specifically for post-deployment steps after using the AVM template. For complete deployment from scratch, see the main [Deployment Guide](./DeploymentGuide.md).
+
+---
+
 This document provides guidance on post-deployment steps after deploying the Build Your Own Copilot Accelerator from the [AVM (Azure Verified Modules) repository](https://github.com/Azure/bicep-registry-modules/tree/main/avm/ptn/sa/build-your-own-copilot).
 
 ## Post Deployment Steps
-1. Clone the Repository
-    First, clone this repository to access the post-deployment scripts:
-    ```bash
-    git clone https://github.com/microsoft/Build-your-own-copilot-Solution-Accelerator.git
-    ```
-    ```bash
-    cd Build-your-own-copilot-Solution-Accelerator
-    ```
 
-2. Import Sample Data -Run bash command printed in the terminal. The bash command will look like the following:
+### 1. Clone the Repository
+First, clone this repository to access the post-deployment scripts:
+
+```bash
+git clone https://github.com/microsoft/Build-your-own-copilot-Solution-Accelerator.git
+cd Build-your-own-copilot-Solution-Accelerator
+```
+
+### 2. Import Sample Data 
+
+**Choose the appropriate command based on your deployment method:**
+
+**If you deployed using custom templates, ARM/Bicep deployments, or `az deployment group` commands:**
+```bash 
+bash ./infra/scripts/process_sample_data.sh <your-resource-group-name>
+```
+> **Note**: Replace `<your-resource-group-name>` with the actual name of the resource group containing your deployed Azure resources.
+
+> **💡 Tip**: If the deployment metadata does not exist in Azure or has been deleted, the script will prompt you to manually enter the required configuration values.
+
+**If you deployed using `azd up` command:**
+```bash 
+bash ./infra/scripts/process_sample_data.sh 
+```
+> **Note**: The script will automatically take required values from your `azd` environment.
+
+> **💡 Tip**: Since this guide is for AVM deployments, you'll most likely use the first command with your resource group name.
+
+### 3. Configure Authentication
 
-    ```bash 
-    bash ./infra/scripts/process_sample_data.sh <resourceGroupName> 
-    ```
-    If the deployment does not exist or has been deleted – The script will prompt you to manually enter the required values
+Follow the steps in [App Authentication](./AppAuthentication.md) to configure authentication in App Service. 
 
-3. Add Authentication Provider
+> **Note**: Authentication changes can take up to 10 minutes to propagate.
 
-    Follow steps in [App Authentication](https://github.com/microsoft/Build-your-own-copilot-Solution-Accelerator/blob/main/docs/AppAuthentication.md) to configure authentication in app service. 
-    >Note that Authentication changes can take up to 10 minutes.
+### 4. Troubleshooting: Cleaning Up After a Failed Deployment
 
-4. Deleting Resources After a Failed Deployment
+If your deployment fails and you need to clean up resources, follow the steps in [Delete Resource Group](./DeleteResourceGroup.md).
 
-    Follow steps in [Delete Resource Group](https://github.com/microsoft/Build-your-own-copilot-Solution-Accelerator/blob/main/docs/DeleteResourceGroup.md) if your deployment fails and/or you need to clean up the resources.
+---
 
-By following these steps, you’ll ensure a smooth transition from deployment to hands-on usage.
+By following these steps, you'll ensure a smooth transition from deployment to hands-on usage.

docs/DeploymentGuide.md

@@ -238,22 +238,35 @@ This will rebuild the source code, package it into a container, and push it to t
 
 ## Post Deployment Steps
 
-1. **Import Sample Data**
-   -please open a **Git Bash** terminal and run the bash command printed below. The bash command will look like the following: 
-    ```shell 
-    bash ./infra/scripts/process_sample_data.sh
-    ```
-    if you don't have azd env then you need to pass parameters along with the command. Then the command will look like the following:
-    ```shell
-    bash ./infra/scripts/process_sample_data.sh <resourceGroupName> <cosmosDbAccountName> <storageAccount> <storageContainerName> <keyvaultName> <sqlServerName> <sqlDatabaseName> <webAppUserManagedIdentityClientId> <webAppUserManagedIdentityDisplayName> <aiFoundryResourceName> <aiSearchResourceName>
-    ```
+### 1. Import Sample Data 
+
+**Choose the appropriate command based on your deployment method:**
+
+**If you deployed using `azd up` command:**
+```bash 
+bash ./infra/scripts/process_sample_data.sh 
+```
+> **Note**: The script will automatically take required values from your `azd` environment.
+
+**If you deployed using custom templates, ARM/Bicep deployments, or `az deployment group` commands:**
+```bash 
+bash ./infra/scripts/process_sample_data.sh <your-resource-group-name>
+```
+> **Note**: Replace `<your-resource-group-name>` with the actual name of the resource group containing your deployed Azure resources.
+
+> **💡 Tip**: If the deployment metadata does not exist in Azure or has been deleted, the script will prompt you to manually enter the required configuration values.
+
+> **💡 Tip**: Since this guide is for azd deployment, you'll most likely use the first command without resource group name.
+
+### 2. Configure Authentication
+
+Follow the steps in [App Authentication](./AppAuthentication.md) to configure authentication in App Service. 
 
-2. **Add Authentication Provider**  
-    - Follow steps in [App Authentication](./AppAuthentication.md) to configure authentication in app service. Note that Authentication changes can take up to 10 minutes. 
+> **Note**: Authentication changes can take up to 10 minutes to propagate.
 
-3. **Deleting Resources After a Failed Deployment**  
+### 3. Troubleshooting: Cleaning Up After a Failed Deployment
 
-     - Follow steps in [Delete Resource Group](DeleteResourceGroup.md) if your deployment fails and/or you need to clean up the resources.
+If your deployment fails and you need to clean up resources, follow the steps in [Delete Resource Group](./DeleteResourceGroup.md).
 
 ## Environment configuration for local development & debugging
 > Set APP_ENV in your .env file to control Azure authentication. Set the environment variable to dev to use Azure CLI credentials, or to prod to use Managed Identity for production. **Ensure you're logged in via az login when using dev in local**.