Интеграция Azure Pipelines с Microsoft Teams

Azure DevOps Services

Примечание.

Эта функция доступна только в Azure DevOps Services. Как правило, новые функции впервые вводятся в облачной службе, а затем становятся доступными в локальной среде в следующей основной версии или обновлении Azure DevOps Server. Дополнительные сведения см. в статье "Временная шкала компонентов Azure DevOps".

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

Примечание.

Уведомления Azure Pipelines не поддерживаются в чате Teams или прямых сообщениях.

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

• Доступ к команде в Microsoft Teams, где можно добавить приложение.
• Разрешения администратора проекта или администратора сборки в проекте Azure DevOps. Дополнительные сведения см. в статье "Создание проекта и ресурсов безопасности конвейера".
• Доступ к сторонним приложениям через OAuth включен в параметрах организации Azure DevOps.

Настройка приложения Azure Pipelines

1. В Microsoft Teams выберите "Приложения", найдите Azure Pipelines и выберите Azure Pipelines.

   

2. Щелкните стрелку раскрывающегося списка рядом с кнопкой "Добавить" и нажмите кнопку "Добавить в команду".

   

3. Выберите или введите имя команды, а затем выберите " Настройка бота".

   

Использование команд приложений Azure Pipelines

Приложение Azure Pipelines Teams поддерживает следующие команды:

Команда с косой чертой	Функция
@azure вход конвейеров	Войдите в учетную запись Azure Pipelines.
@azure Выход конвейеров	Выйдите из учетной записи Azure Pipelines.
@azure URL-адрес конвейера подписки <на конвейер конвейера конвейера | URL-адрес проекта>	Подписка на конвейер или все конвейеры в проекте для получения уведомлений.
@azure подписки конвейеров	Просмотр, добавление или удаление подписок для этого канала.
@azure Конвейеры отменяют подписку на весь <URL-адрес проекта>	Удалите все конвейеры, принадлежащие проекту, и связанные с ними подписки из канала.
@azure Справка по конвейерам	Получите справку по командам.
@azure Отзывы о конвейерах	Сообщите о проблеме или предложите функцию.

Вход в Azure Pipelines

1. В области бесед Teams введите @azurePipelines signin.
2. Выберите вход и завершите проверку подлинности в Azure Pipelines.

Подписка на конвейеры

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

• Все конвейеры в проекте: URL-адрес может быть вашим проектом или любой страницей в проекте, за исключением конвейера. Например:

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/
  

• Конкретный конвейер: URL-адрес конвейера может быть на любой странице в конвейере с URL-адресом definitionId или buildId/releaseId в URL-адресе. Например:

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  

Развертывание связанных уведомлений

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

Чтобы развернуть поток, выберите канал сжатого потока.

Управление подписками

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

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

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

1. Чтобы вывести список всех подписок конвейеров, выполните @azure pipelines subscriptions команду.

   

2. Чтобы удалить подписку, выберите "Просмотреть все подписки". Выберите " Удалить " в любой подписке, которую вы не хотите, и нажмите кнопку "ОК".

3. Чтобы добавить подписку, нажмите кнопку "Добавить подписку".

4. Выберите событие и конвейер, на который вы хотите подписаться, и нажмите кнопку "Далее".

5. Выберите нужные фильтры этапов и среды , нажмите кнопку "Отправить" и нажмите кнопку "ОК".

   Например, следующая подписка предоставляет уведомления для этапа _default только при сбое состояния завершения.

   

Примечание.

Администраторы групп не могут удалять или изменять подписки, созданные администраторами проектов.

Просмотр уведомлений об утверждении

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

Если подписаться на уведомление о завершении утверждения этапа запуска, вы также можете увидеть, когда этап утвержден.

Примечание.

Вы не можете подписаться на утверждения развертывания с удостоверением утверждающего повторного утверждения перед применением политики утверждения .

Утверждение из канала

Если вы утверждающий, вы можете утвердить развертывания из канала Teams. Приложение Azure Pipelines поддерживает все сценарии проверки и утверждения Azure Pipelines. Вы можете утвердить запросы в качестве отдельного человека или команды.

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

Ответ отправляется приложению.

Если вы подписаны на уведомления о завершении утверждения этапа, вы также можете увидеть, когда этап утвержден.

Отмена подписки на канал

unsubscribe Выполните команду, чтобы удалить все подписки, связанные с любым конвейером в проекте, и удалите конвейеры из канала. Например:

@azure pipelines unsubscribe all https://dev.azure.com/myorg/myproject

Чтобы удалить проект и все подписки из канала, нажмите кнопку "Продолжить".

Внимание

Эту команду могут выполнять только администраторы проектов.

Использование расширения compose

Чтобы помочь вам найти и поделиться информацией о конвейерах, приложение Azure Pipelines для Teams поддерживает расширение создания в сообщениях. Расширение можно использовать для поиска конвейеров в проекте по идентификатору конвейера или имени конвейера.

Чтобы использовать расширение, необходимо войти в проект Azure Pipelines в канале Teams. + Выберите символ в поле сообщения, выберите Azure Pipelines и найдите конвейер или выпуск.

Предварительная версия URL-адресов конвейера

При использовании расширения создания для добавления URL-адреса конвейера в сообщение Teams отображается предварительная версия, аналогичная приведенным ниже изображениям. Предварительная версия помогает поддерживать актуальные и актуальные беседы, связанные с конвейером.

В следующем примере показан предварительный просмотр URL-адреса выпуска:

Подключение нескольких клиентов

Если вы используете разные электронные письма или клиенты для Microsoft Teams и Azure DevOps, выполните следующие действия, чтобы войти и подключиться на основе параметров.

Microsoft Teams	Azure DevOps	Действие входа
email1@abc.com (tenant1)	email1@abc.com (tenant1)	Выберите Вход
email1@abc.com (tenant1)	email2@pqr.com (клиент2)	1. Войдите в Azure DevOps. 2. В том же браузере запустите новую вкладку и перейдите к https://teams.microsoft.com/ней. 3. Выполните sign in команду и нажмите кнопку "Войти".
email1@abc.com (tenant1)	email2@pqr.com (клиент2)	1. Выберите вход с другим адресом электронной почты. 2. В средство выбора идентификатора электронной почты используйте электронную почту 2 для входа.
email1@abc.com (tenant1)	email2@pqr.com (nondefault tenant3)	Не поддерживается.

Устранение проблем с проверкой подлинности

В том же браузере запустите новую вкладку и войдите в https://teams.microsoft.com/систему. @Azure Pipelines signout Выполните команду, а затем выполните @Azure Pipelines signin команду в канале, где установлено приложение Azure Pipelines для Microsoft Teams.

Нажмите кнопку входа и завершите процесс входа. Убедитесь, что отображаемый каталог совпадает с выбранным на предыдущем шаге.

Если эти действия не устраняют проблему проверки подлинности, обратитесь к Сообщество разработчиков.

Связанные статьи

• Использование Azure Boards с Microsoft Teams
• Использование Azure Repos с Microsoft Teams