Использование Azure Pipelines с Microsoft Teams

Azure DevOps Services

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

Примечание.

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

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

• У вас должен быть проект Azure DevOps. Дополнительные сведения см. в разделе Создание проекта.
• Чтобы настроить подписки конвейера, необходимо быть Администратор istrator project.

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

1. В Microsoft Teams перейдите в магазин приложений, найдите Azure Pipelines и выберите Azure Pipelines.

   

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

   

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

   

4. В области бесед Teams введите @azurePipelines signin.

5. Выберите вход и завершите проверку подлинности в Azure Pipelines.

Использование команд

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

• Отслеживайте все конвейеры в проекте. URL-адрес может быть любой страницей в проекте, за исключением URL-адресов конвейеров. Например, @azure pipelines subscribe https://dev.azure.com/myorg/myproject/.

  @azure pipelines subscribe [project url]
  

• Отслеживайте определенный конвейер: URL-адрес конвейера может быть на любой странице в конвейере, где есть definitionId или buildId/releaseId присутствует в URL-адресе. Например, @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123.

  @azure pipelines subscribe [pipeline url]
  

  Еще одним примером конвейера выпуска, который подписан на развертывание выпуска, завершено развертывание выпуска, а также уведомления @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releasesо ожидании утверждения развертывания выпуска.

Примечание.

• Мы не поддерживаем утверждения развертывания, которые применили удостоверение утверждающего повторно перед завершением политики утверждения .
• Включите доступ к сторонним приложениям через OAuth для получения уведомлений для организации в Azure DevOps.

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

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

1. Выполните команду @azure pipelines subscriptions.

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

3. Прокрутите вниз и выберите "Добавить подписку".

4. Выберите обязательный конвейер и событие.

5. Выберите соответствующие фильтры и сохраните.

   Пример 1. Получение уведомлений о неудачных сборках.

   

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

   

   Примечание.

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

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

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

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

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

Поиск и совместное использование сведений о конвейере с помощью расширения compose

Чтобы помочь пользователям выполнять поиск и совместное использование сведений о конвейерах, приложение Azure Pipelines для Microsoft Teams поддерживает расширение создания. Теперь можно искать конвейеры по идентификатору конвейера или по имени конвейера. Чтобы расширение создания работало, пользователи должны войти в проект Azure Pipelines, который они интересуют, выполнив @azure pipelines signin команду или выполнив вход в расширение создания напрямую.

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

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

Пример 1. Предварительная версия URL-адреса сборки

Пример 2. Предварительная версия URL-адреса выпуска

После входа эта функция работает для всех каналов в команде в Microsoft Teams.

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

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

@azure pipelines unsubscribe all [project url]

Пример: отмена подписки на все с URL-адресом

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

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

Внимание

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

Связывание уведомлений

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

Пример 1. Компактное представление связанных уведомлений.

Пример 2. Расширенное представление связанных уведомлений.

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

См. следующие команды, поддерживаемые приложением Azure Pipelines:

Команда с косой чертой	Функция
@azure конвейеры подписываются [URL-адрес конвейера/ URL-адрес проекта]	Подписка на конвейер или все конвейеры в проекте для получения уведомлений
@azure подписки конвейеров	Добавление или удаление подписок для этого канала
@azure Отзывы о конвейерах	Сообщите о проблеме или предложите функцию
@azure Справка по конвейерам	Получение справки по командам косой черты
@azure вход конвейеров	Вход в учетную запись Azure Pipelines
@azure Выход конвейеров	Выход из учетной записи Azure Pipelines
@azure конвейеры отменяют подписку на все [URL-адрес проекта]	Удаление всех конвейеров (принадлежащих к проекту) и связанных с ними подписок из канала

Подключение мультитенантные

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

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

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

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

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

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

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

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