Skip to content

chore: Enhance deployment guides and improve OneLake data source creation#132

Open
Harmanpreet-Microsoft wants to merge 1 commit intomicrosoft:devfrom
Harmanpreet-Microsoft:dev-main
Open

chore: Enhance deployment guides and improve OneLake data source creation#132
Harmanpreet-Microsoft wants to merge 1 commit intomicrosoft:devfrom
Harmanpreet-Microsoft:dev-main

Conversation

@Harmanpreet-Microsoft
Copy link
Copy Markdown
Contributor

This pull request improves the configuration and deployment experience for Microsoft Fabric resources by clarifying BYO (Bring Your Own) workflows, standardizing environment variable usage, and enhancing automation scripts to better support both new and existing deployments. The documentation now provides clearer guidance for each deployment mode, and the infrastructure and automation scripts have been updated to consistently read from environment variables and persist resource identifiers for downstream use.

Documentation improvements:

  • Expanded documentation in docs/parameter_guide.md and docs/deploymentguide.md to clearly explain the different Fabric deployment modes (create, byo, none), how to set them using environment variables, and detailed steps for reusing existing Fabric capacities and workspaces. This includes guidance on how to locate required resource identifiers and the precedence of environment variables over hardcoded values. [1] [2]

Infrastructure configuration:

  • Updated infra/main.bicepparam to read fabricCapacityResourceId, FABRIC_WORKSPACE_ID, and FABRIC_WORKSPACE_NAME from environment variables, ensuring that BYO resource identifiers can be supplied at deploy time via azd env set.

Automation script enhancements:

  • Modified create_lakehouses.ps1 to persist created and existing lakehouse IDs into the environment using azd env set, making them available for downstream scripts and reruns.
  • Improved 04_create_onelake_datasource.ps1 to robustly resolve workspace and lakehouse IDs by checking Bicep outputs, environment variables, and persisted values from previous automation steps, increasing reliability in both new and BYO scenarios.

Purpose

  • ...

Does this introduce a breaking change?

  • Yes
  • No

Golden Path Validation

  • I have tested the primary workflows (the "golden path") to ensure they function correctly without errors.

Deployment Validation

  • I have validated the deployment process successfully and all services are running as expected with this change.

What to Check

Verify that the following are valid

  • ...

Other Information

… configuration

feat: update bicepparam to read environment variables for fabric capacity and workspace
scripts: persist lakehouse IDs in azd env for downstream hooks
scripts: improve OneLake data source creation with azd outputs and env store fallback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant