fabric-deploy
Skill1 starsChanged 34 days agoMITView on GitHub
Use when deploying, promoting or releasing Microsoft Fabric or Power BI items between workspaces — dev → test → prod, CI/CD — by any route: the fabric-cicd Python library (`FabricWorkspace`, `publish_all_items`, `parameter.yml`, `config.yml`), `fab deploy`, Git integration's Update From Git, or a deployment pipeline, scripted or run from Azure DevOps or GitHub Actions. Picks the route, checks the identity, shows the plan and stops before writing to a later stage, then verifies the deploy.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- microsoft/fabric-task-flowstheir own version, first seen May 13, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- microsoft/fabric-task-flows★ 49same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository38 other files it gives its agents.
- claude/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- author-skillSkill
- drift-auditSkill
- drift-handoffSkill
- drift-updateSkill
- test-skillSkill
- triageSkill
- fabric-iqSkill
- fabric-catalog-governanceSkill
- fabric-rest-apiSkill
- fabric-securitySkill
- fabric-variable-librarySkill
- fabric-databaseSkill
- fabric-dataflowSkill
- fabric-data-pipelineSkill
- fabric-sparkSkill
- fabric-warehouse-monitoringSkill
- fabric-warehouseSkill
- fabric-activatorSkill
- fabric-eventhouseSkill
- fabric-event-schema-setSkill
- fabric-eventstreamSkill
- fabric-realtime-dashboardSkill
- learnSkill
- fabric-semantic-model-auditSkill
- fabric-tmdlSkill
- pbip-project-structureSkill
- pbir-report-workflowSkill
- linkedin-highlightsSkill
- msix-packagingSkill
- code-reviewSkill
- commitSkill
- find-sessionSkill
- landSkill
- prune-branchesSkill
- recreate-repoSkill
- run-briefsSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 4 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 66
Import instead (Learn, 2026-10-06).
- Very specific: line 102
Before this session itself runs any of these, show what will change and wait for the user's yes, as land stops before main:
- Very specific: line 118
Library or
fab deploy: every run is a full deploy, so list the item types and folders in scope, whether orphans go, and any … - Distinctive: line 124
Deployment pipelines: no API compares stages before a deploy, so list the stage items with their pairing.
- Distinctive: line 132
Read the route's reference, from the table in step 1, before its first call: request shapes, flags and limits are not repeated here.
- Very specific: line 143
Read the operation's result.
- Distinctive: line 150
Check pairing and bindings: on a pipeline, each item's pairing through List stage items.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Deploying Fabric content
A deploy moves item definitions from a source, a Git branch or a workspace, into a target workspace. Four routes do it, each with its own reference; this file picks one and wraps it in the steps every route shares. Take them in order: a wrong route invalidates every step after it.
1. Pick the route
| Source of truth | Route | Learn's option | Read |
| Git, one branch pushed to each stage by a script or CI | the fabric-cicd Python library | 2 | fabric-cicd.md |
| Git, the same in one command | fab deploy --config, which wraps the library and reads its config.yml and parameter.yml | 2 | fab-deploy.md, then fabric-cicd.md |
| Git, a branch per stage, each stage's workspace connected | Git integration's Update From Git | 1 | fabric-rest-api § Git Integration APIs |
| The workspace: dev promoted to test and prod in the service | deployment pipelines | 3 | deployment-pipelines.md |
Learn's option 2 also names the Bulk Import Item Definitions API, which
the library calls under enable_bulk_publish; Learn's
tutorial
calls it directly.
Never deploy into one workspace by both routes. The library makes its target match the repository, overwriting whatever a pipeline promoted, and an item a Git route adds to a pipeline stage is not paired with its source (deployment-pipelines.md § Item pairing and autobinding). Git on the first stage with pipelines onward is not a mix: it is option 3, whose source of truth Learn gives as "Fabric workspace (Git only through dev)" (read 2026-10-09). Decision guide: Choose the best Fabric CI/CD workflow.
2. Preflight, every route
Identity. Name the identity the deploy will run as, and check:
- a workspace role on the target: Contributor or above for the library
and
fab deploy, Admin forenable_hard_delete; - for a service principal, on any route, the tenant setting Service principals can call Fabric public APIs (older Learn pages: can use Fabric APIs);
- for Update From Git, the caller's own Git credentials;
- for a deployment pipeline, a second permission system on top of the
workspace roles, pipeline Admin, and on a delegated token the
deploy-only scope,
Pipeline.DeployorDeploymentPipeline.Deploy.All(deployment-pipelines.md § Permissions, § Delegated scopes).
What can move. Each route carries its own set of item types: the library's caveats are in fabric-cicd.md § Item-type caveats, and a pipeline skips whatever is missing from deployment-pipelines-tables.md § Supported item types. Four caveats cross routes, and each lives here:
- Deployment plans (preview): the fabric-cicd library doesn't support them; attach one through Update From Git, Deploy Stage Content or Bulk Import instead (Learn, 2026-10-06). The pipeline call's shape is in deployment-pipelines.md § Deploying.
OneLake image URLs: deployment pipelines don't rewrite them. A report whose visuals source images from OneLake carries the workspace GUID in each URL, so a promoted copy keeps loading them from the source workspace, and nothing fails or warns until access to that workspace is revoked or it is deleted:
https://onelake.dfs.fabric.microsoft.com/<workspace-guid>/<item-guid>/Files/<path>/<file-name>Upstream's remedies are deployment-pipeline parameters or a rewrite after deployment. Whether
parameter.yml'sfind_replacereaches a report definition for this is unverified, and whether Git integration,fab deployor the library rewrite these URLs is undocumented, which is not "no" (Learn).- PBIR reports: item 9 of Learn's general limitations lists them as
unsupported in deployment pipelines, yet a PBIR-stored report has
deployed to Test and Prod and redeployed in production use, per the
pipeline's own records (2026-08-25/26). Treat item 9 as a claim to test,
not a blocker, and don't stop the
pbir-*workflow on it; the evidence is in deployment-pipelines-tables.md § Supported item types. - Direct Lake semantic models are the one model type a pipeline doesn't autobind: deployed with its lakehouse, the target model still points at the source stage's lakehouse until a rule rebinds it, and which rule depends on the flavour (deployment-pipelines.md § Item pairing and autobinding).
3. Plan, then stop
Before this session itself runs any of these, show what will change and
wait for the user's yes, as land stops before main:
- a write to any stage past the first, test and prod above all;
- an orphan delete:
unpublish_all_orphan_items, aconfig.ymlwhose missingunpublishblock unpublishes orphans by default, orenable_hard_delete, which bypasses the recycle bin; - a backward deploy, or an unassign, which destroys the stage's deployment history and its rules for good.
"Deploy it to prod" names a target, not what changes there, so it is not the yes. Writing a CI pipeline file, or a script for the user to run, deploys nothing and needs no stop.
What to show, by route:
- Library or
fab deploy: every run is a full deploy, so list the item types and folders in scope, whether orphans go, and anyenable_*_unpublishflag that lets a data-bearing item be deleted. - Update From Git: the
changes[]from Get Status. A body of just the two hashes applies or refuses and never overwrites; say so if the plan addsallowOverrideItemsor aconflictResolution, which do. - Deployment pipelines: no API compares stages before a deploy, so list the stage items with their pairing. An unpaired item lands as a new copy, a selective deploy deletes nothing in the target, and an empty target stage gets a new workspace whose only admin is the deploying identity.
4. Run
Read the route's reference, from the table in step 1, before its first call: request shapes, flags and limits are not repeated here. On a pipeline, deployment-pipelines-tables.md adds the supported items, the full permission tables and the rule limitations.
5. Verify
A deploy moves metadata, not data, on every route. After one:
- Read the operation's result. A pipeline deploy that failed keeps its
error on one step of
executionPlan.steps[], and the steps after it stayNotStarted, not deployed (deployment-pipelines.md § Deploying). - Refresh in the target, each dataflow before the semantic models that read it.
- Check pairing and bindings: on a pipeline, each item's pairing through List stage items; on any route, each report bound to the target's semantic model and each Direct Lake model reading the target's lakehouse.
- Name what the deploy did not carry. On a pipeline that includes a semantic model's refresh schedule, credentials and role assignments (deployment-pipelines-tables.md § What a deploy copies).
6. When it fails
| Symptom | Cause, and where the fix is |
| 403 from a pipeline call | Say which system is missing: pipeline Admin, a workspace role on both stages, or Pipeline.Deploy on a delegated token. deployment-pipelines.md § Permissions, § Delegated scopes |
| 401 or "credential required" from the library | Since v1.0 it needs an explicit token_credential. fabric-cicd.md § Troubleshooting |
| An item duplicated instead of overwritten | Pairing. deployment-pipelines.md § Item pairing and autobinding |
| A report that lost its semantic model | Autobinding, in the same section |
| Rules that didn't apply | Rules apply on the next deploy. deployment-pipelines.md § Deployment rules |
A parameter.yml value not substituted | fabric-cicd.md § Troubleshooting |
| An orphan lakehouse or warehouse not deleted | On purpose, behind a flag. fabric-cicd.md § Feature flags |
| Deploy to the previous stage greyed out | deployment-pipelines.md § Limits and gotchas |
A 404 from fab api on a pipeline path | The audience. deployment-pipelines.md § Through fab |
| Update From Git refuses to start | fabric-rest-api § Git Integration APIs |
| Anything else on a pipeline | deployment-pipelines-tables.md § Troubleshooting |
See also
fabric-rest-api— long-running operations, Git integration, and the definition APIs every route sits on;fab apimechanics in itsreferences/cli.md; token audiences and service principal setup in itsreferences/auth.mdfabric-variable-library— value sets, the other way to vary config per stage- A Data Factory pipeline's activities are
fabric-data-pipeline's, a different thing from a deployment pipeline despite the name
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

