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


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

Azure DevOps Services

Если вы используете Slack, вы также можете использовать приложение Azure Repos для Slack, чтобы легко отслеживать репозитории Azure Repos. Настройте подписки и управляйте ими для получения уведомлений в канале всякий раз, когда код отправляется или проверка и при каждом создании, обновлении или слиянии запроса на вытягивание (PR). Это приложение поддерживает события Git и системы управления версиями Team Foundation (TFVC).

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

Примечание.

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

Добавление приложения Azure Repos в рабочую область Slack

  1. Перейдите в приложение Azure Repos Slack и выберите "Добавить в Slack".

    Снимок экрана: каталог приложений Slack, Azure Repos и кнопка

    После добавления вы получите примерно следующее приветственное сообщение.

    Снимок экрана: приветственное сообщение из Slack.

  2. Используйте дескриптор /azrepos Slack для взаимодействия с приложением. Полный список команд представлен в разделе справочника по командам этой статьи.

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

  1. Подключение и пройти проверку подлинности в Azure Repos с помощью /azrepos signin команды.

    Снимок экрана: запрос входа для Slack.

  2. Выберите Вход.

  3. Примите интеграцию Azure Repos Slack.

    Снимок экрана: кнопка

    Код проверки отображается для использования в приложении чата для завершения проверки подлинности.

  4. Скопируйте код проверки подлинности.

    Снимок экрана: код проверки, предоставленный Azure Repos.

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

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

    Подтверждение входа в чате.

    Снимок экрана: подтверждение входа в чате.

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

/azrepos subscribe [project url]

URL-адрес проекта может быть на любой странице проекта (кроме URL-адресов для репозиториев). Например:

/azrepos subscribe https://dev.azure.com/myorg/myproject/

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

/azrepos subscribe [repository url]

URL-адрес репозитория может быть на любой странице в репозитории с именем репозитория. Например, для репозиториев Git используйте:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_git/myrepository

Для репозиториев TFVC используйте:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_versionControl

Примечание.

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

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

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

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

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

/azrepos subscriptions

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

Примечание.

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

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

Использование фильтров для настройки подписок

Когда пользователь подписывается на репозиторий с помощью /azrepos subscribe команды, создается подписка по умолчанию. Часто пользователям необходимо настроить эти подписки. Например, пользователям может потребоваться получать уведомления только в том случае, если У PR есть конкретный рецензент.

Ниже показано, как настроить подписки.

  1. Выполните команду /azrepos subscriptions.
  2. В списке подписок, если есть подписка, которая является нежелательной или должна быть изменена (например, создание шума в канале), нажмите кнопку "Удалить ".
  3. Нажмите кнопку "Добавить подписку ".
  4. Выберите необходимый репозиторий и нужное событие.
  5. Выберите соответствующие фильтры.

Пример. Получение уведомлений только в том случае, если моя команда находится в списке рецензентов для PR

Снимок экрана: рецензент имеет мою команду.

Пример. Сообщите мне, когда попытки слияния завершаются ошибкой из-за нарушения политики

Снимок экрана: неудачная попытка слияния из-за нарушения политики.

Примечание.

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

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

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

Снимок экрана: отмена url-адреса.

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

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

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

/azrepos unsubscribe all [project url]

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

/azrepos unsubscribe all https://dev.azure.com/myorg/myproject

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

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

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

Уведомления в частных каналах

Приложение Azure Repos также может помочь отслеживать события репозитория в частных каналах. Пригласите бота в частный канал с помощью /invite @azrepos. Затем вы можете управлять уведомлениями так же, как и для общедоступного канала.

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

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

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

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

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

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

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

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

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

В том же браузере запустите новую вкладку, перейдите https://slack.comк ней и войдите в рабочее пространство (используйте веб-клиент). /azrepos signout Выполните команду, /azrepos signin за которой следует команда.

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

Снимок экрана: согласие на запрошенные разрешения приложения.

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