Использование 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-адресов запроса на вытягивание
- Удаление подписок и репозиториев из канала
Предварительные условия
- Управляйте подпиской, чтобы получать уведомления в канале при отправке или возврате кода, а также при создании, обновлении или слиянии запроса на вытягивание (PR). Для создания подписок на события, связанные с репозиторием, необходимо быть членом группы "Администраторы проекта" или администратором команды. Сведения о добавлении см. в разделах Изменение разрешений на уровне проекта или Добавление администратора команды.
- Чтобы получать уведомления, включите параметр Доступ к сторонним приложениям через OAuth для организации Azure DevOps. См. раздел Изменение политик доступа к приложениям для организации.
Примечание
- Уведомления в настоящее время не поддерживаются в прямых сообщениях.
- Вы можете связать приложение Azure Repos для Microsoft Teams только с проектом, размещенным на Azure DevOps Services.
Добавление приложения Azure Repos в команду в Microsoft Teams
Перейдите к приложению Azure Repos в Microsoft Teams, Microsoft Teams > Azure Repos.
Выберите Добавить или, если вы уже скачали приложение, выберите раскрывающееся меню рядом с кнопкой Открыть, а затем выберите Добавить в команду.
Введите имя команды или канала, а затем выберите Настройка бота.
Подключение приложения Azure Repos к репозиториям
После установки приложения в команде введите следующий текст в поле ответа:
@azure repos signinЕсли microsoft Teams и Azure Boards находятся в разных клиентах, выберите Войти с помощью другой электронной почты.
Чтобы отслеживать все репозитории 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.Команда
subscribeпозволяет начать работу с подпиской по умолчанию. Для репозиториев Git канал подписывается на событие создания запроса на вытягивание (с целевой ветвью = main). Для репозиториев TFVC канал подписывается на событие "Возвращенный код ".
Управление подписками
Чтобы просмотреть, добавить и удалить подписки для канала, введите следующий текст: @azure repos subscriptions.
Вы увидите список всех текущих подписок для канала и можете добавить новые подписки или удалить существующие. Настройте уведомления с помощью различных фильтров, как описано в следующем разделе.
Примечание
Администраторы команды не могут удалять или изменять подписки, созданные администраторами проекта.
Используйте фильтры для получения только нужных уведомлений
При подписке на репозиторий с @azure repos subscribeпомощью создается подписка по умолчанию без применения фильтров.
Часто пользователям требуется настроить эти подписки, чтобы получать уведомления только при соблюдении определенных условий.
На следующих снимках экрана показан пример настройки уведомлений только в том случае, если наша команда находится в списке рецензентов для запроса на вытягивание.
Введите в канал следующий текст:
@azure repos subscriptions.Если в списке подписок есть подписка, которую вы не хотите или которую необходимо изменить, выберите Удалить , чтобы удалить ее.
Нажмите кнопку Добавить подписку .
Выберите тип события и нажмите кнопку Далее.
Выберите репозиторий и нажмите кнопку Далее.
Выберите соответствующие фильтры для настройки подписки, а затем нажмите кнопку Отправить.
Примечание
- Все фильтры обычно являются раскрывающимся списком. Однако если раскрывающийся список содержит более 100 элементов, необходимо вручную ввести значения.
- Для события TFVC Code Checked in фильтр В пути должен иметь формат
$/myproject/path.
Поиск и совместное использование сведений о запросах на вытягивание с помощью расширения Compose
Чтобы помочь пользователям в поиске и совместном использовании сведений о запросах на вытягивание, Azure Repos приложение для Microsoft Teams поддерживает расширение compose. Вы можете искать запросы на вытягивание по идентификатору или имени. Чтобы расширение работало, войдите в проект Azure Repos, введя @azure repos signin или выполнив вход непосредственно в расширение compose.
Предварительный просмотр 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 для параметра организации значение Включено.
Сбой настройки. Убедитесь, что организация "{название_организации}" существует и у вас есть достаточные разрешения.
Выйдите из 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 и вы будете перенаправлены на страницу согласия, как в следующем примере. Убедитесь, что каталог, отображаемый рядом с адресом электронной почты, совпадает с каталогом, выбранным на предыдущем шаге. Примите и завершите процесс входа.
Если эти действия не помогли устранить проблему с проверкой подлинности, обратитесь к нам по адресу Сообщество разработчиков.