CI/CD для приложений организации в Fabric (предварительная версия)

В этой статье объясняется, как интеграция Git и конвейеры развертывания работают для приложений организации в Microsoft Fabric. Узнайте, как настроить подключение к репозиторию, управлять приложением организации с помощью Git и развертывать его в разных средах.

Интеграция с приложениями организации и Git

Подключение к репозиторию Git

В параметрах рабочей области настройте подключение к репозиторию для фиксации и синхронизации изменений. См. статью Начало работы с интеграцией Git для настройки подключения.

После подключения рабочее пространство отображает информацию о средстве управления исходными кодами, которая позволяет просматривать подключённую ветку, статус каждого элемента в ветке и время последней синхронизации.

Представление приложений организации в Git

При фиксации элемента приложения организации в репозитории Git создается папка для каждого элемента и дается имя . Он содержит два файла:

  • файл, который создается системой автоматически. Дополнительные сведения см. в системных файлах.
  • файл, который определяет элемент приложения организации.

Файл определения разделен на два раздела:

  • Статические параметры: описание внешнего внешнего вида приложения, например темы, логотипа и параметров взаимодействия.
  • Элементы: описание внутренней структуры приложения.
    • Элементы раздела: элементы-контейнеры с собственной коллекцией приложений Org
    • Элементы элемента: элементы Power BI.

На следующей схеме показана структура приложения организации.

Схема, показывающая структуру элемента приложения Org. Статические параметры отображаются над приложением Org, а элементы элемента следуют за ним.

Файл определения содержит следующее:

  • Настройки
    • Logo
    • Тема
      • Предыстория
      • Передний план
      • BackgroundHover
      • Выбор фона
      • ФонНажат
    • Настройки интерфейса
      • Панель навигации
        • Скрыто
        • Свернуто
        • НезависимаяНавигацияПоСтранице
    • НастройкиТипаЭлемента
    • Отчет
      • Скрыть панель страницы
  • Элементы
    • ElementType (может быть: обзор, раздел, элемент или ссылка)
    • ElementId
    • ItemType (только для ElementType: item)
    • ItemLogicalId (только для ElementType: item)
    • isHidden (не когда для ElementType: обзор)
    • Отображаемое имя
    • Заголовок (только для ElementType: обзор)
      • Название
      • Тело
      • ПоказатьТему
    • Элементы (только для ElementType: section)
    • URL-адрес (только для ElementType: ссылка)
    • LinkType (только для ElementType: link. Значения встроенный или новая вкладка)

Следующий код 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 можно использовать для развертывания приложения организации в разных средах, таких как разработка, тестирование и рабочая среда. И вы можете использовать правила развертывания для настройки приложения организации.

Сведения об использовании конвейеров развертывания см. в статье "Общие сведения о конвейерах развертывания".

Для сложных развертываний с несколькими рабочими областями или рабочих процессов CI/CD на основе Git с конфигурациями, зависящими от среды, можно также использовать средство fabric-cicd, которое может использовать определения приложений организации из Git и применять преобразования на этапах разработки, тестирования и prod.

Замечание

Ограничение: Приложения организации (предварительная версия) нельзя развертывать на разных этапах с помощью служебных учетных записей.