Skip to content

DeploymentGuideFabricManual.md

Latest commit

 

History

History
101 lines (66 loc) · 4.09 KB

DeploymentGuideFabricManual.md

File metadata and controls

101 lines (66 loc) · 4.09 KB
Raw

Deployment Guide (Manual Option) for Medallion Architecture and PBI in Fabric

This guide describes how to deploy the Unified Data Foundation with Fabric solution accelerator by importing and running the udf_solution_installer.ipynb notebook directly in a Microsoft Fabric workspace — no local tooling or scripts required.

When to Use Manual Installation

  • You prefer not to install azd or run local scripts
  • You have an existing Fabric capacity and want a quick, portal-only deployment
  • You're evaluating the solution with minimal setup

Prerequisites

  • Microsoft Fabric capacity must already exist (Fabric capacity or trial)
  • Fabric workspace with capacity assigned
  • Workspace permissions to create and manage Fabric items

How to Install

Step 1: Create a Fabric Workspace

  1. Log in to Microsoft Fabric
  2. Click Workspaces → + New workspace
  3. Name your workspace (e.g., Unified Data Foundation)
  4. Assign a Fabric capacity or trial capacity
  5. Click Apply

Step 2: Download the Solution Installer Notebook

Download the udf_solution_installer.ipynb notebook to a local folder on your computer.

Step 3: Import and Run the Solution Installer

  1. In your Fabric workspace, click + New item → Import notebook
  2. Navigate to the folder where you saved udf_solution_installer.ipynb
  3. Upload and open the udf_solution_installer notebook
  4. Click Run all to execute the deployment

The installer notebook will:

  • ✅ Install required Python packages
  • ✅ Create lakehouses (bronze, silver, gold)
  • ✅ Deploy and configure all solution notebooks
  • ✅ Upload sample data files
  • ✅ Deploy Power BI reports
  • ✅ Run post-deployment configuration tasks

Deployment Verification

After the notebook completes, verify the following items exist in your workspace:

  • ✅ Lakehouses: bronze, silver, and gold lakehouses
  • ✅ Notebooks: All transformation and utility notebooks
  • ✅ Sample Data: CSV files loaded in the bronze lakehouse Files section
  • ✅ Power BI Reports: Reports deployed from the reports/ directory

Troubleshooting

Issue Possible Cause Resolution
Notebook import fails File format unsupported Ensure you downloaded the raw .ipynb file
Workspace capacity error No capacity assigned Assign a Fabric capacity or trial to the workspace
Installer notebook cell fails Missing permissions or dependency Review the failed cell output for details and re-run from that cell
Items not created Notebook run incomplete Confirm all cells completed; re-run any failed cells individually

Cleanup

To remove the deployed solution, delete the workspace from the Fabric portal:

  1. Navigate to Microsoft Fabric
  2. Open Workspace settings for the installed workspace
  3. Scroll to the bottom and select Delete this workspace

⚠️ Important: Deleting the workspace removes all contained items permanently.

Next Steps

After successful deployment:

  1. Explore the workspace: Review the deployed lakehouses, notebooks, and reports
  2. Customize for your needs: Modify notebooks and data pipelines for your specific requirements
  3. Consider automation: Use azd up for repeatable infrastructure provisioning alongside Fabric deployment — see DeploymentGuideFabric.md

Additional Resources

This manual deployment guide is part of the Unified Data Foundation with Fabric solution accelerator. For the latest updates and documentation, visit the official repository.