You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -61,7 +61,7 @@ Not all Fabric items can be managed the same way. From a lifecycle management pe
61
61
| Category | Description | Examples |
62
62
|---|---|---|
63
63
|**Git-tracked**| Items supported by [Fabric Git integration](https://learn.microsoft.com/en-us/fabric/cicd/git-integration/intro-to-git-integration#supported-items). Their definitions are serialized to files in the repo, enabling version control, branching, and code-review workflows. | Notebooks, Semantic Models, Lakehouses, Reports, Variable Libraries, Data Pipelines, Environments |
64
-
|**Deployment Pipeline–only**| Items not supported by Git integration but supported by [Fabric Deployment Pipelines](https://learn.microsoft.com/en-us/fabric/cicd/deployment-pipelines/intro-to-deployment-pipelines#supported-items). They can be promoted workspace-to-workspace but cannot be version-controlled in Git. |Ontologies (at the time of writing) |
64
+
|**Deployment Pipeline–only**| Items not supported by Git integration but supported by [Fabric Deployment Pipelines](https://learn.microsoft.com/en-us/fabric/cicd/deployment-pipelines/intro-to-deployment-pipelines#supported-items). They can be promoted workspace-to-workspace but cannot be version-controlled in Git. |Template Apps (at the time of writing) |
65
65
|**Manual**| Items supported by neither Git integration nor Deployment Pipelines. These must be created and configured manually in each workspace. | Varies as Microsoft continues adding support — always check the official supported items lists |
66
66
67
67
> **Important:** Both supported items lists evolve as Microsoft adds capabilities. Always verify against the official documentation before assuming an item falls into a particular category.
Copy file name to clipboardExpand all lines: fabric-cicd-release-options.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -45,7 +45,7 @@ Git integration only works with a specific set of Fabric items. **Any item not o
45
45
46
46
For the full list of supported items, see the [official documentation](https://learn.microsoft.com/en-us/fabric/cicd/git-integration/intro-to-git-integration#supported-items) linked in the References section.
47
47
48
-
> **Important:****Ontologies are not supported** by Git integration at this time.
48
+
> **Important:****Template Apps are not supported** by Git integration at this time.
49
49
50
50
51
51
---
@@ -340,7 +340,7 @@ Technically, the Terraform provider can *create* items like notebooks in a targe
I recommend a **hybrid approach** that uses **fabric-cicd** for all supported items and **Fabric Deployment Pipelines** for unsupported items (e.g., Ontologies). This gives us Git as the single source of truth for the majority of items, with a clean path to drop the Deployment Pipelines component as items gain support.
343
+
I recommend a **hybrid approach** that uses **fabric-cicd** for all supported items and **Fabric Deployment Pipelines** for unsupported items (e.g., Template Apps). This gives us Git as the single source of truth for the majority of items, with a clean path to drop the Deployment Pipelines component as items gain support.
@@ -370,7 +370,7 @@ I recommend a **hybrid approach** that uses **fabric-cicd** for all supported it
370
370
#### Dev Stage (Trigger: PR merged → `dev` branch)
371
371
1.**Update from Git API** syncs the Dev workspace with the latest commit on the `dev` branch.
372
372
2. Run **Data Pipelines / Notebooks** for ETL jobs as needed.
373
-
3.**Unsupported items** (e.g., Ontologies) are **manually created and updated** in the Dev workspace only. These items are not in Git and have no version history — they exist only in the workspace and move between stages via Deployment Pipelines.
373
+
3.**Unsupported items** (e.g., Template Apps) are **manually created and updated** in the Dev workspace only. These items are not in Git and have no version history — they exist only in the workspace and move between stages via Deployment Pipelines.
374
374
4. Validate and test in the Dev workspace.
375
375
376
376
#### Test Stage (Trigger: PR merged → `test` branch)
@@ -409,16 +409,16 @@ Two complementary mechanisms handle environment-specific configuration:
409
409
410
410
-**Git as source of truth** for all supported items across all stages.
411
411
-**fabric-cicd's `parameter.yml`** handles environment-specific configuration declaratively — no custom scripts.
412
-
-**Deployment Pipelines** fill the gap for unsupported items (Ontologies) with minimal overhead.
412
+
-**Deployment Pipelines** fill the gap for unsupported items with minimal overhead.
413
413
-**Variable Libraries** provide clean runtime auto-binding, reducing the surface area of deployment-time parameterization.
414
-
-**Forward-looking** — when Ontologies gain Git integration and fabric-cicd support, the Deployment Pipeline steps drop away entirely, simplifying the flow to fabric-cicd end-to-end.
414
+
-**Forward-looking** — when/if Template Apps gain Git integration and fabric-cicd support, the Deployment Pipeline steps drop away entirely, simplifying the flow to fabric-cicd end-to-end.
415
415
-**Git, branching strategies, and CI/CD pipelines** align with the Customer's DevSecOps Strategy document.
416
416
417
417
---
418
418
419
419
### Future State
420
420
421
-
When Ontologies (and any other currently unsupported items) gain Git integration and fabric-cicd support:
421
+
When/If Template Apps (and any other currently unsupported items) gain Git integration and fabric-cicd support:
422
422
-**Drop the Deployment Pipeline entirely.**
423
423
-**fabric-cicd handles all items end-to-end** — the sandwich pattern is no longer needed.
424
424
- The flow simplifies to: PR merged → fabric-cicd deploys → run ETL → validate.
@@ -440,7 +440,7 @@ When Ontologies (and any other currently unsupported items) gain Git integration
440
440
441
441
#### Hotfix Flow (Unsupported Items via Deployment Pipelines)
442
442
443
-
- If the hotfix touches **Ontology or other unsupported items**, promote via Deployment Pipelines from the previous stage (e.g., Test → Prod).
443
+
- If the hotfix touches **Template Apps or other unsupported items**, promote via Deployment Pipelines from the previous stage (e.g., Test → Prod).
444
444
- Automate with the [Deploy Stage Content](https://learn.microsoft.com/en-us/rest/api/fabric/core/deployment-pipelines/deploy-stage-content) API; selective deploy requires explicitly listing items (no "select related" in API).
445
445
446
446
> **Note:** Deployment Pipelines provide the governance path but don't give you Git-based version history. Keep a known-good version in the earlier stage so you can re-deploy forward if needed.
Each deploy workflow orchestrates three sequential jobs via `needs:`:
127
127
128
128
1.**deploy-supported** — fabric-cicd publishes all supported items (Lakehouse, Variable Library, Notebooks, Semantic Model, Report) from Git to the target workspace. Item types are explicitly scoped via `item_type_in_scope` to ensure correct deployment ordering (Lakehouse before Variable Library and Semantic Model).
129
-
2.**promote-unsupported***(skeleton)* — Will promote unsupported items (e.g., Ontologies) from the previous stage via the Fabric Deployment Pipelines REST API. Currently prints a TODO message.
129
+
2.**promote-unsupported***(skeleton)* — Will promote unsupported items (e.g., Template Apps) from the previous stage via the Fabric Deployment Pipelines REST API. Currently prints a TODO message.
130
130
3.**deploy-supported-dependent***(skeleton)* — Will deploy supported items that depend on unsupported items via fabric-cicd. Currently prints a TODO message.
131
131
132
132
The ETL workflow only triggers after **all 3 jobs** complete successfully. If any job fails, the entire deploy workflow is marked as failed and ETL does not run.
133
133
134
134
### Future Simplification
135
135
136
-
When Ontologies (and other unsupported items) gain Git integration and fabric-cicd support, the skeleton jobs can be removed — simplifying the flow to a single fabric-cicd deploy followed by ETL.
136
+
When Template Apps (and other unsupported items) gain Git integration and fabric-cicd support, the skeleton jobs can be removed — simplifying the flow to a single fabric-cicd deploy followed by ETL.
0 commit comments