Fabric 中组织应用的 CI/CD (预览版)

本文介绍 Git 集成部署管道 如何适用于 Microsoft Fabric 中的 组织应用 。 了解如何设置与存储库的连接,通过 Git 管理组织应用,以及如何在不同的环境中部署它。

组织应用和 Git 集成

连接到 Git 存储库

在工作区设置中,设置存储库的连接以提交和同步更改。 要设置连接,请参阅 Git 集成入门一文。

连接后,工作区会显示有关源代码管理的信息,可用于查看连接的分支、分支中每个项的状态以及上次同步的时间。

Git 中的组织应用表示形式

将组织应用项提交到 Git 存储库时,会为每个项创建一个文件夹并命名 {display name}.OrgApp。 它包含两个文件:

  • .platform 由系统自动生成的文件。 从 系统文件了解详细信息。
  • definition.json 文件,它是组织应用项的定义。

定义文件分为两个部分:

  • 静态设置:描述应用的外部外观,例如主题、徽标和体验设置。
  • 元素:描述应用的内部结构。
    • 节元素:具有自己组织应用的集合的容器元素
    • 项目元素:Power BI 项目。

下图显示了组织应用的结构。

显示 Org 应用项结构的示意图。静态设置显示在 Org 应用上方,项目元素紧随其后。

定义文件包含:

  • 设置
    • 徽标
    • 主题
      • 背景
      • 前景
      • BackgroundHover
      • 背景已选
      • 背景按压
    • 体验设置
      • 导航窗格
        • IsHidden
        • 是否折叠
        • 独立页面导航
    • 项目类型设置
    • 报告
      • 隐藏页面窗格
  • 元素
    • ElementType (可以是 :概述链接
    • ElementId
    • ItemType (仅适用于 ElementType: item
    • ItemLogicalId(仅适用于 ElementType: item
    • isHidden (仅在 ElementType 为 概述 时隐藏)
    • 显示名称
    • 标头(仅适用于 ElementType: 概述
      • 标题
      • 身体
      • ShowTheme
    • 元素(仅适用于 ElementType:
    • URL (仅适用于 ElementType: link
    • LinkType(仅适用于 ElementType:link。值为 嵌入新标签页

以下 JSON 代码是组织应用项的文件示例 definition.json

{
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/orgapp/definition/orgAppDefinition/1.0.0/schema.json",
  "settings": {
    "theme": {
      "background": "#2fb136",
      "foreground": "#000000",
      "backgroundHover": "#59c15e",
      "backgroundSelected": "#82d086",
      "backgroundPressed": "#ace0af"
    }
  },
  "elements": [
    {
      "elementType": "item",
      "elementId": "08e649a9-0fe6-40bd-b0c3-7fc900b7550f",
      "itemType": "Report",
      "itemLogicalId": "e0fa7df4-5528-4c37-bf2c-9ec02ffef18d",
      "isHidden": false,
      "displayName": "Daily Dashboard"
    },
    {
      "elementType": "item",
      "elementId": "410f87ee-8402-49b0-abbb-31cb69dc1ebc",
      "itemType": "SemanticModel",
      "itemLogicalId": "8f633535-6fb4-467f-a668-6bc55c5735b8",
      "isHidden": false,
      "displayName": "410f87ee-8402-49b0-abbb-31cb69dc1ebc"
    }
  ]
}

部署管道中的组织应用

可以使用 Fabric 部署管道跨不同的环境(例如开发、测试和生产)部署组织应用。 可以使用部署规则来自定义组织应用。

若要了解如何使用部署管道,请参阅 部署管道简介

注释

限制:组织应用(预览版)无法使用服务主体跨阶段部署。