Skip to content

Commit a732cae

Browse files
docs: replace Ontologies with Template Apps as unsupported item example
1 parent 0672e62 commit a732cae

3 files changed

Lines changed: 10 additions & 10 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Not all Fabric items can be managed the same way. From a lifecycle management pe
6161
| Category | Description | Examples |
6262
|---|---|---|
6363
| **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) |
6565
| **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 |
6666

6767
> **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.

fabric-cicd-release-options.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ Git integration only works with a specific set of Fabric items. **Any item not o
4545

4646
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.
4747

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.
4949
5050

5151
---
@@ -340,7 +340,7 @@ Technically, the Terraform provider can *create* items like notebooks in a targe
340340

341341
### Hybrid Approach — fabric-cicd + Deployment Pipelines
342342

343-
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.
344344

345345
![Hybrid Recommendation Flow](assets/hybrid-recommendation-flow.svg)
346346

@@ -370,7 +370,7 @@ I recommend a **hybrid approach** that uses **fabric-cicd** for all supported it
370370
#### Dev Stage (Trigger: PR merged → `dev` branch)
371371
1. **Update from Git API** syncs the Dev workspace with the latest commit on the `dev` branch.
372372
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.
374374
4. Validate and test in the Dev workspace.
375375

376376
#### Test Stage (Trigger: PR merged → `test` branch)
@@ -409,16 +409,16 @@ Two complementary mechanisms handle environment-specific configuration:
409409

410410
- **Git as source of truth** for all supported items across all stages.
411411
- **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.
413413
- **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.
415415
- **Git, branching strategies, and CI/CD pipelines** align with the Customer's DevSecOps Strategy document.
416416

417417
---
418418

419419
### Future State
420420

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:
422422
- **Drop the Deployment Pipeline entirely.**
423423
- **fabric-cicd handles all items end-to-end** — the sandwich pattern is no longer needed.
424424
- 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
440440
441441
#### Hotfix Flow (Unsupported Items via Deployment Pipelines)
442442

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).
444444
- 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).
445445

446446
> **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.

fabric-hybrid-cicd-guide.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -126,14 +126,14 @@ microsoft-fabric-sdlc-patterns/
126126
Each deploy workflow orchestrates three sequential jobs via `needs:`:
127127

128128
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.
130130
3. **deploy-supported-dependent** *(skeleton)* — Will deploy supported items that depend on unsupported items via fabric-cicd. Currently prints a TODO message.
131131

132132
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.
133133

134134
### Future Simplification
135135

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.
137137

138138
---
139139

0 commit comments

Comments
 (0)