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

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

Внимание

Эта функция доступна в предварительной версии.

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

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

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

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

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

Необходимые компоненты

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

• Те же предварительные требования, которые необходимо использовать для конвейеров развертывания.
• Токен Microsoft Entra для службы Fabric. Используйте этот маркер в заголовке авторизации вызова API. Сведения о том, как получить токен, см. в кратком руководстве по API Fabric.

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

• PowerShell
• Модуль Azure PowerShell Az

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

ИНТЕРФЕЙСы REST API Fabric для конвейеров развертывания позволяют выполнять следующие функции:

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

• Вывод списка конвейеров развертывания. Возвращает список конвейеров развертывания, к которым у пользователя есть доступ.

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

• Получение элементов этапа конвейера развертывания. Возвращает поддерживаемые элементы из рабочей области, назначенной указанному этапу указанного конвейера развертывания.

• Развертывание содержимого этапа. Развертывает элементы из указанного этапа указанного конвейера развертывания.

  • Используйте этот API для развертывания всех элементов или выбора определенных элементов для развертывания. Если определенные элементы не выбраны, все элементы развертываются.

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

  • Этот API интегрирован с API длительных операций для мониторинга состояния развертывания.

    • Получите состояние операции, чтобы узнать, завершена ли операция с ПОМОЩЬЮ API состояния get Long Running ( Get Operation State API).
    • Через 24 часа после завершения развертывания сведения о расширенном развертывании доступны вAPI получения результатов операции.

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

Примеры для PowerShell

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

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

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

  • Имя конвейера
  • Имя исходного этапа
  • Имя целевого этапа
  • Заметки о развертывании (необязательно)

• Выборочное развертывание

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

  • Имя конвейера
  • Имя исходного этапа
  • Имя целевого этапа
  • Элементы для развертывания (отображаемое имя элементов и тип элемента)
  • Заметки о развертывании (необязательно)

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

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

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

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

• Субъекты-службы поддерживаются только для элементов Power BI.

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

  • allowPurgeData
  • allowTakeOver
  • allowSkipTilesWithMissingPrerequisites

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

Связанный контент

• Начало работы с конвейерами развертывания
• Рекомендации по конвейерам развертывания
• Устранение неполадок конвейеров развертывания