Skip to content

Latest commit

 

History

History
157 lines (102 loc) · 5.75 KB

DeploymentGuide.md

File metadata and controls

157 lines (102 loc) · 5.75 KB

Deployment Guide

This guide walks you through deploying the Unified Data Foundation with Fabric solution accelerator to your Azure subscription.

Architecture Options

Choose the architecture that best fits your organizational needs:

Option Architecture Description
1 Microsoft Fabric Core medallion lakehouse with Power BI dashboards
2 Fabric + Purview Adds data governance and compliance capabilities
3 Fabric + Databricks Adds cross-platform analytics integration
4 Fabric + Purview + Databricks Complete enterprise solution with all components

Note: Option 1 is required as the foundation. Options 2–4 build upon it.

For detailed architecture diagrams and feature descriptions, see Technical Architecture.

Prerequisites

Before you begin, ensure you have the following:

Requirement Description
Azure subscription An active Azure subscription. Create a free account if needed.
Permissions Contributor role and RBAC permissions at the subscription level.
Fabric capacity Microsoft Fabric capacity of F64 or higher.

For detailed setup instructions, see Azure Account Setup.

💡 Recommended: Run the Quota Check before deployment to verify resource availability.

Deploy Option 1: Microsoft Fabric (Required)

Deploys 3 lakehouses (Bronze, Silver, Gold), 48 notebooks, 2 SQL scripts, and Power BI dashboards.

Azure Cloud Shell GitHub Codespaces Dev Container 
git clone https://github.com/microsoft/unified-data-foundation-with-fabric-solution-accelerator.git
cd unified-data-foundation-with-fabric-solution-accelerator
azd auth login
azd up

⏱️ Deployment time: 15–20 minutes

Alternative Methods

Method Guide
Manual Manual Deployment
Detailed Fabric Deployment Guide
Local Dev Local Development Setup

After Deployment

Deploy Option 2: Add Purview (Optional)

Adds data governance, metadata management, and compliance capabilities.

Prerequisite: Complete Option 1 first.

Step Guide
1 Setup Purview
2 Configure Governance

Deploy Option 3: Add Databricks (Optional)

Add Azure Databricks for cross-platform analytics and advanced data processing capabilities.

Prerequisite: Complete Option 1 deployment first.

Step Description Guide
1 Provision Azure Databricks Setup Databricks
2 Deploy Databricks resources Databricks Deployment Guide

This deploys 1 Silver lakehouse, 7 notebooks, 2 SQL scripts, and sample data to Databricks.

For details on the notebooks, see Databricks Notebooks Guide.

Deploy Option 4: Complete Solution

Deploy all components for a full enterprise data platform.

Steps:

  1. Complete Option 1 (Fabric)
  2. Complete Option 2 (Purview)
  3. Complete Option 3 (Databricks)

Verify Your Deployment

After deployment, verify everything is working:

Step Action
1 Open Microsoft Fabric and navigate to your workspace
2 Confirm Bronze, Silver, and Gold lakehouses exist
3 Execute the runner notebooks to process sample data
4 Open Power BI reports and verify dashboards display data

Clean Up Resources

To avoid ongoing costs, remove all deployed resources when no longer needed:

azd down

Alternatively, delete the resource group directly in the Azure Portal.

Troubleshooting

Issue Solution
Deployment fails Verify capacity requirements are met
Permission errors Confirm Contributor and RBAC roles are assigned
Timeout errors Re-run azd up to resume deployment

For additional help, see FAQs or submit an issue.

Next Steps

Resource Description
Sample Workflows Try guided examples with the deployed solution
Power BI Configuration Configure dashboards and semantic models
Fabric Notebooks Guide Understand the medallion architecture notebooks
Fabric Data Agent Guide Set up natural language querying
Copilot for Power BI Guide Enable AI-powered report exploration