Бөлісу құралы:


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

Azure DevOps Services

Если вы используете Microsoft Teams и Azure Repos, вы можете использовать приложение Azure Repos для Teams для отслеживания репозиториев. Приложение поддерживает мониторинг репозиториев Git и система управления версиями Team Foundation (TFVC), но не поддерживает интеграцию с репозиториями GitHub.

Из этой статьи вы узнаете, как выполнять следующие задачи:

  • Добавление приложения Azure Repos в команду в Microsoft Teams
  • Подключение приложения Azure Repos к репозиториям
  • Управление подписками для репозитория событий в канале
  • Поиск и совместное использование сведений о запросах на вытягивание с помощью расширения Compose
  • Предварительный просмотр URL-адресов запроса на вытягивание
  • Удаление подписок и репозиториев из канала

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

Примечание

  • Уведомления в настоящее время не поддерживаются в прямых сообщениях.
  • Вы можете связать приложение Azure Repos для Microsoft Teams только с проектом, размещенным на Azure DevOps Services.

Добавление приложения Azure Repos в команду в Microsoft Teams

  1. Перейдите к приложению Azure Repos в Microsoft Teams, Microsoft Teams > Azure Repos.

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

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

    Снимок экрана: приветственное сообщение от Azure Repos в Teams.

Подключение приложения Azure Repos к репозиториям

  1. После установки приложения в команде введите следующий текст в поле ответа: @azure repos signin

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

    Снимок экрана: запись входа в Teams для Azure Repos.

    Снимок экрана: полный ответ на вход.

  2. Чтобы отслеживать все репозитории Git в проекте, введите @azure repos subscribe [project url] в канал. Не забудьте добавить URL-адрес проекта. URL-адрес проекта может быть любой странице в проекте (кроме URL-адресов репозиториев).

    Вы также можете отслеживать определенный репозиторий с помощью: @azure repos subscribe [repo url].

    URL-адрес репозитория может находиться на любой странице в репозитории с именем репозитория, например , @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepoили для репозиториев TFVC: @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

  3. Команда subscribe позволяет начать работу с подпиской по умолчанию. Для репозиториев Git канал подписывается на событие создания запроса на вытягивание (с целевой ветвью = main). Для репозиториев TFVC канал подписывается на событие "Возвращенный код ".

    Снимок экрана: сообщение о создании подписок по умолчанию.

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

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

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

Примечание

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

Просмотр подписок

Используйте фильтры для получения только нужных уведомлений

При подписке на репозиторий с @azure repos subscribeпомощью создается подписка по умолчанию без применения фильтров. Часто пользователям требуется настроить эти подписки, чтобы получать уведомления только при соблюдении определенных условий. На следующих снимках экрана показан пример настройки уведомлений только в том случае, если наша команда находится в списке рецензентов для запроса на вытягивание.

  1. Введите в канал следующий текст: @azure repos subscriptions.

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

  3. Нажмите кнопку Добавить подписку .

  4. Выберите тип события и нажмите кнопку Далее.

    Снимок экрана: выбор типа события.

  5. Выберите репозиторий и нажмите кнопку Далее.

    Снимок экрана: выбор репозитория.

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

    Снимок экрана: выбранные фильтры.

Примечание

  • Все фильтры обычно являются раскрывающимся списком. Однако если раскрывающийся список содержит более 100 элементов, необходимо вручную ввести значения.
  • Для события TFVC Code Checked in фильтр В пути должен иметь формат $/myproject/path.

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

Чтобы помочь пользователям в поиске и совместном использовании сведений о запросах на вытягивание, Azure Repos приложение для Microsoft Teams поддерживает расширение compose. Вы можете искать запросы на вытягивание по идентификатору или имени. Чтобы расширение работало, войдите в проект Azure Repos, введя @azure repos signin или выполнив вход непосредственно в расширение compose.

Снимок экрана: расширение compose.

Предварительный просмотр URL-адресов запросов на вытягивание

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

Снимок экрана: распаковка URL-адреса.

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

Чтобы удалить все подписки, связанные с любым репозиторием в проекте, и удалить репозитории из канала, введите в Teams следующий текст: @azure repos unsubscribe all [project url]. Обязательно введите URL-адрес проекта. Эту задачу могут выполнять только администраторы проекта.

Потоковые уведомления

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

Компактное представление потоковых уведомленийСнимок экрана: компактное представление потоковых уведомлений.

Развернутое представление потоковых уведомленийСнимок экрана: развернутое представление потоковых уведомлений.

Справочник по командам

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

Get-Help Функциональность
@azure repos subscribe [repo url/ project url] Подписка на репозиторий или все репозитории в проекте для получения уведомлений
@azure repos subscriptions Добавление и удаление подписок для этого канала
@azure repos signin Войдите в Azure Repos организацию
@azure repos signout Выход из организации Azure Repos
@azure repos feedback Сообщить о проблеме или предложить функцию
@azure repos unsubscribe all [project url] Удаление всех репозиториев (принадлежащих проекту) и связанных с ними подписок из канала

Поддержка мультитенантного режима

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

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

Диагностика

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

Произошла ошибка. Повторите попытку.

Приложение Azure Repos использует протокол проверки подлинности OAuth и требует для организации доступа к сторонним приложениям через OAuth. Чтобы включить этот параметр, перейдите в раздел Параметры организации Политики>безопасности> и установите для параметра Доступ к сторонним приложениям через OAuth для параметра организации значение Включено.

Включение доступа к сторонним приложениям через OAuth для организации

Сбой настройки. Убедитесь, что организация "{название_организации}" существует и у вас есть достаточные разрешения.

Выйдите из Azure DevOps, перейдя в https://aka.ms/VsSignout браузер.

Откройте окно браузера In private or incognito , перейдите по адресу https://aex.dev.azure.com/me и войдите в систему. В раскрывающемся списке под значком профиля слева выберите каталог, содержащий организацию, содержащую репозиторий, на который вы хотите подписаться.

Выберите каталог, содержащий организацию, содержащую проект.

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

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

Согласие на запрошенные разрешения приложения

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