Merge pull request #127 from Rafi-Microsoft/psl-addingfiles

feat: Add quota check scripts for Azure OpenAI models and Fabric capacity

Author: Roopan-Microsoft

docs/quota_check.md

@@ -1,64 +1,97 @@
 # Check Quota Availability Before Deployment
 
-Before deploying the accelerator, **ensure sufficient quota availability** for the required model.
-> **We recommend increasing the capacity to 100k tokens for optimal performance.**
+Before deploying the accelerator, **ensure sufficient quota availability** for the required AI models and Fabric capacity.
+> **The default capacities match the deployment parameters in `infra/main.bicepparam`.**
 
 ## Login if you have not done so already
 ```
 az login
 ```
 
 ## 📌 Default Models & Capacities:
+These match the `modelDeploymentList` in the Bicep parameters:
 ```
-gpt-4o:150, gpt-4o-mini:150, gpt-4:150, text-embedding-3-small:100
+gpt-4.1-mini:40:GlobalStandard, text-embedding-3-large:40:Standard
 ```
+
 ## 📌 Default Regions:
 ```
-eastus, uksouth, eastus2, northcentralus, swedencentral, westus, westus2, southcentralus, canadacentral, australiaeast, japaneast, norwayeast
+eastus, eastus2, swedencentral, uksouth, westus, westus2, southcentralus, canadacentral, australiaeast, japaneast, norwayeast
 ```
+
+## 📌 Optional: Fabric Capacity Check
+The accelerator also deploys a **Microsoft Fabric F8** capacity. Pass `--check-fabric` (bash) or `-CheckFabric` (PowerShell) to verify Fabric SKU availability.
+
 ## Usage Scenarios:
 - No parameters passed → Default models and capacities will be checked in default regions.
 - Only model(s) provided → The script will check for those models in the default regions.
 - Only region(s) provided → The script will check default models in the specified regions.
 - Both models and regions provided → The script will check those models in the specified regions.
 - `--verbose` passed → Enables detailed logging output for debugging and traceability.
+- `--check-fabric` passed → Also checks Microsoft Fabric capacity availability.
 
-## **Input Formats**
-> Use the --models, --regions, and --verbose options for parameter handling:
+## **Input Formats — Bash**
+> Use the --models, --regions, --verbose, and --check-fabric options for parameter handling:
 
-✔️ Run without parameters to check default models & regions without verbose logging:
-   ```
-  ./quota_check.sh
+✔️ Run without parameters to check default models & regions:
+   ```sh
+   ./quota_check.sh
    ```
 ✔️ Enable verbose logging:
-   ```
-  ./quota_check.sh --verbose
+   ```sh
+   ./quota_check.sh --verbose
    ```
 ✔️ Check specific model(s) in default regions:
-  ```
-  ./quota_check.sh --models gpt-4o:150,text-embedding-3-small:100
+  ```sh
+  ./quota_check.sh --models gpt-4.1-mini:40:GlobalStandard,text-embedding-3-large:40:Standard
   ```
 ✔️ Check default models in specific region(s):
-  ```
-./quota_check.sh --regions eastus,westus
-  ```
-✔️ Passing Both models and regions:  
-  ```
-  ./quota_check.sh --models gpt-4o:150 --regions eastus,westus2
+  ```sh
+  ./quota_check.sh --regions eastus,westus
   ```
 ✔️ All parameters combined:
+  ```sh
+  ./quota_check.sh --models gpt-4.1-mini:40 --regions eastus,westus --verbose
+  ```
+✔️ Also check Fabric capacity availability:
+  ```sh
+  ./quota_check.sh --check-fabric --verbose
   ```
- ./quota_check.sh --models gpt-4:150,text-embedding-3-small:100 --regions eastus,westus --verbose
+
+## **Input Formats — PowerShell**
+> Use the -Models, -Regions, -Verbose, and -CheckFabric parameters:
+
+✔️ Run without parameters:
+   ```powershell
+   .\quota_check.ps1
+   ```
+✔️ Check specific model(s):
+  ```powershell
+  .\quota_check.ps1 -Models "gpt-4.1-mini:40:GlobalStandard,text-embedding-3-large:40:Standard"
   ```
-✔️ Multiple models with single region:
+✔️ Check specific region(s):
+  ```powershell
+  .\quota_check.ps1 -Regions "eastus,westus2"
   ```
- ./quota_check.sh --models gpt-4:150,text-embedding-3-small:100 --regions eastus2 --verbose
+✔️ All parameters combined:
+  ```powershell
+  .\quota_check.ps1 -Models "gpt-4.1-mini:40" -Regions "eastus,westus" -CheckFabric -Verbose
   ```
 
 ## **Sample Output**
 The final table lists regions with available quota. You can select any of these regions for deployment.
 
-![quota-check-output](../img/Documentation/quota-check-output.png)
+```
+╔══════════════════════════════════════════════════════════════╗
+║                     QUOTA CHECK SUMMARY                    ║
+╚══════════════════════════════════════════════════════════════╝
+
+Region                gpt-4.1-mini                  text-embedding-3-large        Status
+──────────────────────────────────────────────────────────────────────────────────────────
+eastus                ✅ 200/240 (need 40)           ✅ 120/200 (need 40)           ✅ PASS
+eastus2               ❌ 10/240 (need 40)            ✅ 50/200 (need 40)            ❌ FAIL
+swedencentral         ✅ 100/240 (need 40)           ✅ 80/200 (need 40)            ✅ PASS
+```
 
 ---
 ## **If using Azure Portal and Cloud Shell**
@@ -74,22 +107,33 @@ The final table lists regions with available quota. You can select any of these
     chmod +x quota_check.sh
     ./quota_check.sh
     ```
-    - Refer to [Input Formats](#input-formats) for detailed commands.
+    - Refer to [Input Formats — Bash](#input-formats--bash) for detailed commands.
 
 ## **If using VS Code or Codespaces**
+
+### Option 1: Bash (Linux, macOS, Git Bash, WSL, Cloud Shell)
 1. Open the terminal in VS Code or Codespaces.
-2. Use a terminal that can run bash. This is only for the quota check script; deployment uses PowerShell.
+2. Use a terminal that can run bash.
   ![git_bash](../img/provisioning/git_bash.png)
-3. Navigate to the `scripts` folder where the script files are located and make the script as executable:
+3. Navigate to the `scripts` folder and make the script executable:
    ```sh
     cd scripts
     chmod +x quota_check.sh
     ```
-4. Run the appropriate script based on your requirement:  
-
-   **To check quota for the deployment**  
-
+4. Run the script:
     ```sh
     ./quota_check.sh
     ```
-   - Refer to [Input Formats](#input-formats) for detailed commands.
+   - Refer to [Input Formats — Bash](#input-formats--bash) for detailed commands.
+
+### Option 2: PowerShell (Windows, Linux, macOS)
+1. Open a PowerShell terminal in VS Code.
+2. Navigate to the `scripts` folder:
+   ```powershell
+   cd scripts
+   ```
+3. Run the script:
+   ```powershell
+   .\quota_check.ps1
+   ```
+   - Refer to [Input Formats — PowerShell](#input-formats--powershell) for detailed commands.