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

2025-04-30

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

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

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

Получение конвейера развертывания: Возвращает сведения об указанном конвейере развертывания.
Список конвейеров развертывания: возвращает список конвейеров развертывания, к которым у пользователя есть доступ.
Вывод этапов конвейера развертывания: Возвращает этапы указанного развертывания, включая его идентификатор, отображаемое имя, описание и информацию о том, является ли этап общедоступным.
Список элементов этапа развертывания. Возвращает поддерживаемые элементы из рабочей области, назначенной указанному этапу указанного конвейера развертывания.
Развертывание содержимого этапа: Развёртывание элементов из указанного этапа в указанном конвейере развертывания.
- Используйте этот API для развертывания всех элементов или выбора определенных элементов для развертывания. Если определенные элементы не выбраны, все элементы развертываются.
- Чтобы найти соответствующий идентификатор этапа для развертывания, используйте API списка этапов развертывания.
- Этот API интегрирован с API длительных операций для мониторинга состояния развертывания.
  - Получите состояние операции, чтобы узнать, завершена ли она, используя API Get Long Running - Get Operation State.
  - Через 24 часа после завершения развертывания сведения о расширенном развертывании доступны в APIполучения результатов операции .
Создание конвейера развертывания: создание конвейера развертывания.
Удалить конвейер развертывания: Удаление конвейера развертывания.
Обновление конвейера развертывания: обновить конвейер развертывания.
Получение этапа конвейера развертывания. Получение сведений о стадии конвейера развертывания.
Обновление этапа конвейера развертывания: Обновите этап конвейера развертывания.
Добавьте назначение роли конвейера развертывания: добавьте назначение роли в конвейер развертывания.
Удаление назначения роли конвейера развертывания: Удалите назначение роли из конвейера развертывания.
Список назначений ролей конвейера развертывания: перечислить все назначения ролей для конвейера развертывания.
Назначьте рабочую область этапу конвейера развертывания: назначьте рабочую область определенному этапу конвейера развертывания.
Отмена назначения рабочей области из этапа конвейера развертывания: Снять назначение рабочей области из определенного этапа конвейера развертывания.
Получение операции конвейера развертывания. Получение сведений о операции конвейера развертывания.
Перечислить операции конвейера развертывания: перечислить все операции конвейера развертывания.

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

Примеры для PowerShell

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

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

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

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

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

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

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

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

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

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

Примеры для PowerShell

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

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

Обратная связь

Дополнительные ресурсы