Поделиться через


Автоматизация конвейера развертывания с помощью API Fabric

Средство конвейеров развертывания Microsoft Fabric позволяет командам создавать эффективный процесс выпуска, который можно использовать повторно, для контента Fabric.

Используйте интерфейсы REST API Fabric для конвейеров развертывания, чтобы интегрировать Fabric в процесс автоматизации вашей организации. Ниже приведены несколько примеров того, что можно сделать с помощью API:

  • Интеграция Fabric в знакомые средства DevOps, такие как Azure DevOps или GitHub Actions.

  • Планирование развертываний конвейеров выполняется автоматически в определенное время.

  • Разверните несколько конвейеров одновременно.

  • Каскад в зависимости от развертываний конвейеров. Если у вас есть контент, связанный с конвейерами, можно убедиться, что одни конвейеры развертываются перед другими.

Предварительные условия

Чтобы работать с API конвейера развертывания, вам потребуется следующее:

Интерфейсы REST API можно использовать без PowerShell, но скрипты в этой статье используют PowerShell. Чтобы запустить скрипты, необходимо установить следующие программы:

Функции API конвейеров развертывания

REST API Fabric для потоков развертывания позволяют вам выполнять следующие функции:

Для выполнения связанных операций можно также использовать другие вызовы REST API Fabric .

Примеры для PowerShell

Чтобы понять, как выполнять несколько процессов автоматизации, можно использовать следующие скрипты PowerShell. Чтобы просмотреть или скопировать текст в примере PowerShell, используйте ссылки в этом разделе.

Вы также можете скачать всю Fabric-Samples папку GitHub.

  • Развертывание всех

    Введите следующую информацию:

    • Имя конвейера
    • Название исходного этапа
    • Название целевого этапа
    • Заметки о развертывании (необязательно)
    • Тип субъекта. Выберите UserPrincipal или ServicePrincipal. Если субъект-служба, также предоставьте следующее:
      • Идентификатор приложения (клиента) субъекта-службы
      • Идентификатор каталога (клиента) субъекта-службы
      • Значение секрета субъекта-службы
  • Выборочное развертывание

    Введите следующую информацию:

    • Имя конвейера
    • Название исходного этапа
    • Название целевого этапа
    • Элементы для развертывания (отображаемое имя элементов и тип элемента)
    • Заметки о развертывании (необязательно)
    • Тип субъекта. Выберите UserPrincipal или ServicePrincipal. Если это service principal, также предоставьте:
      • Идентификатор приложения (клиента) субъекта-службы
      • Идентификатор каталога (клиента) субъекта-службы
      • Значение секрета служебного принципала
  • Назначьте новому конвейеру развертывания и разверните

    Введите следующую информацию:

    • Идентификатор рабочей области разработки
    • Новое имя рабочей рабочей области
    • Имя конвейера
    • Заметки о развертывании (необязательно)
    • Тип субъекта. Выберите UserPrincipal или ServicePrincipal. Если основной сервис, также предоставьте следующее:
      • Идентификатор приложения (клиента) субъекта-службы
      • Идентификатор каталога (клиента) субъекта-службы
      • Значение секрета идентификатора службы

Рекомендации и ограничения

При использовании API конвейеров развертывания рассмотрите следующие ограничения:

  • Все ограничения, которые применяются к конвейеру развертывания, применяются при использовании API. Дополнительные сведения см. в рекомендациях по конвейерам развертывания.

  • Потоки данных в настоящее время не поддерживаются. Клиенты, использующие потоки данных, могут использовать API Power BI.

  • В Fabric доступны не все варианты развертывания, доступные в API Power BI. Следующие API недоступны в API контента этапа развертывания Fabric:

    • allowPurgeData
    • allowTakeOver
    • разрешить пропускать плитки с отсутствующими предварительными условиями

    Чтобы использовать один из этих API, используйте API Power BI для развертывания. Однако эти API работают только для элементов Power BI.