chore: Automate fabric workspace & fabric capacity creation in Workshop mode

azure.yaml

@@ -13,6 +13,28 @@ metadata:
   template: agentic-applications-for-unified-data-foundation@1.1
 
 hooks:
+  predown:
+    windows:
+      run: |
+        $createWorkspace = $env:CREATE_FABRIC_WORKSPACE
+        if ($createWorkspace -eq "true") {
+            python scripts/02_create_fabric_items.py --cleanup
+        } else {
+            Write-Host "Skipping Fabric workspace cleanup (CREATE_FABRIC_WORKSPACE is not true)."
+        }
+      shell: pwsh
+      continueOnError: true
+      interactive: true
+    posix:
+      run: |
+        if [ "${CREATE_FABRIC_WORKSPACE:-}" = "true" ]; then
+            python scripts/02_create_fabric_items.py --cleanup
+        else
+            echo "Skipping Fabric workspace cleanup (CREATE_FABRIC_WORKSPACE is not true)."
+        fi
+      shell: sh
+      continueOnError: true
+      interactive: true
   postprovision:
     windows:
       run: |

documents/CustomizingAzdParameters.md

@@ -29,6 +29,10 @@ By default this template will use the environment name as the prefix to prevent
 | `IS_WORKSHOP`                             | bool    | `true`                   | Enable workshop mode with sample data and simplified configuration.        |
 | `AZURE_ENV_ONLY`                          | bool    | `false`                  | Deploy Azure SQL Server instead of Fabric SQL.                             |
 | `DEPLOYING_USER_PRINCIPAL_TYPE`           | string  | `User`                   | Principal type of deployer (allowed: `User`, `ServicePrincipal`).          |
+| `AZURE_FABRIC_CAPACITY_NAME`              | string  | ` `                      | Optional. Name of an existing Fabric capacity to reuse. If empty, a new capacity is auto-created in workshop mode. After deploy, this variable holds the resolved capacity name. |
+| `FABRIC_CAPACITY_SKU`                     | string  | `F8`                     | SKU tier for the Fabric capacity (allowed: `F2` through `F2048`).          |
+| `CREATE_FABRIC_WORKSPACE`                | bool    | `false`                  | Set to `true` to auto-create a Fabric workspace during the build script. Requires `AZURE_FABRIC_CAPACITY_NAME`. |
+| `FABRIC_ADMIN_MEMBERS`                   | array   | `[]`                     | Additional user/service principal object IDs to assign as Fabric Capacity admins. |
 
 
 

infra/main.bicep

@@ -94,6 +94,35 @@ param azureEnvOnly bool = false
 param useChatHistoryEnabled bool = true
 var useChatHistoryEnabledSetting = useChatHistoryEnabled ? 'True' : 'False'
 
+// ========== Fabric Capacity Parameters ========== //
+@description('Optional. Name of the Fabric capacity to use. If empty, a new capacity named `fc<solutionSuffix>` is auto-created when isWorkshop is true and azureEnvOnly is false. If set, that capacity is reused and no new capacity is created.')
+param azureFabricCapacityName string = ''
+
+@allowed([
+  'F2'
+  'F4'
+  'F8'
+  'F16'
+  'F32'
+  'F64'
+  'F128'
+  'F256'
+  'F512'
+  'F1024'
+  'F2048'
+])
+@description('Optional. SKU tier of the Fabric capacity resource. Defaults to F8.')
+param fabricCapacitySku string = 'F8'
+
+@description('Optional. An array of user object IDs or service principal object IDs that will be assigned the Fabric Capacity Admin role.')
+param fabricAdminMembers array = []
+
+@description('Set to true to auto-create a Fabric workspace during the build step. When false, capacity creation is also skipped (an existing workspace implies an existing capacity).')
+param createFabricWorkspace bool = false
+
+var useExistingFabricCapacity = !empty(azureFabricCapacityName)
+var shouldCreateFabricCapacity = isWorkshop && !azureEnvOnly && createFabricWorkspace && !useExistingFabricCapacity
+
 // If isWorkshop is false, always deploy; if isWorkshop is true, respect deployApp
 var shouldDeployApp = !isWorkshop || deployApp
 
@@ -161,6 +190,24 @@ resource resourceGroupTags 'Microsoft.Resources/tags@2021-04-01' = if (!isWorksh
   }
 }
 
+// ========== Fabric Capacity (Workshop mode) ========== //
+var fabricCapacityResourceName = useExistingFabricCapacity ? azureFabricCapacityName : 'fc${solutionSuffix}'
+// Fabric Capacity requires a UPN for user admins; service principals (CI/CD) use objectId.
+var fabricCapacityDefaultAdmins = deployer().?userPrincipalName == null
+  ? [deployer().objectId]
+  : [deployer().userPrincipalName]
+var fabricTotalAdminMembers = union(fabricCapacityDefaultAdmins, fabricAdminMembers)
+
+module fabricCapacityModule 'br/public:avm/res/fabric/capacity:0.1.1' = if (shouldCreateFabricCapacity) {
+  name: take('avm.res.fabric.capacity.${fabricCapacityResourceName}', 64)
+  params: {
+    name: fabricCapacityResourceName
+    location: solutionLocation
+    skuName: fabricCapacitySku
+    adminMembers: fabricTotalAdminMembers
+  }
+}
+
 // ========== Managed Identity ========== //
 module managedIdentityModule 'deploy_managed_identity.bicep' = {
   name: 'deploy_managed_identity'
@@ -464,3 +511,12 @@ output AZURE_ENV_DEPLOY_APP bool = deployApp
 
 @description('Flag indicating Azure-only mode (no Fabric)')
 output AZURE_ENV_ONLY bool = azureEnvOnly
+
+@description('The name of the Fabric capacity resource')
+output AZURE_FABRIC_CAPACITY_NAME string = (isWorkshop && !azureEnvOnly && createFabricWorkspace) ? fabricCapacityResourceName : ''
+
+@description('The identities assigned as Fabric Capacity Admin members')
+output AZURE_FABRIC_CAPACITY_ADMINISTRATORS array = (isWorkshop && !azureEnvOnly && createFabricWorkspace) ? fabricTotalAdminMembers : []
+
+@description('The unique solution suffix of the deployed resources')
+output SOLUTION_SUFFIX string = solutionSuffix