Интеграция GitHub с Teams

О интеграции GitHub для Teams

Интеграция GitHub для Microsoft Teams предоставляет вам и вашей команде видимость ваших GitHub проектов непосредственно в каналах Teams. Вы можете разбирать проблемы, сотрудничать над pull-запросами и отслеживать изменения, не выходя из Teams.

С интеграцией GitHub для Teams вы можете:

Получите уведомления GitHub в каналах Teams.
Используйте команды для выполнения действий на GitHub.
Смотрите превью при обмене ссылками на GitHub ресурсы.

Когда вы предоставляете приложению GitHub доступ к вашему рабочему пространству Teams, вы предоставляете ему определённые права. Предоставленные разрешения необходимы для правильной работы приложения и предоставления ожидаемых функций. См . раздел AUTOTITLE.

Необходимые условия

Чтобы использовать интеграцию GitHub для Teams, вам нужно:

Учетная запись GitHub .
Рабочее пространство Teams, где у вас есть разрешение устанавливать приложения.

Установка интеграции GitHub для Teams на GitHub Enterprise Server

Чтобы интегрировать GitHub Enterprise Server с Microsoft Teams, сначала нужно настроить интеграцию чата на вашем экземпляре и зарегистрировать приложение в Microsoft Azure.

Зарегистрируйте приложение и настройте бота Teams

В файле Консоль управления для вашего экземпляра GitHub Enterprise Server откройте страницу интеграции в чат и выберите галочку Enable GitHub Chat integration .
В разделе «Выбрать клиент чата» выберите Microsoft Teams и перейдите по ссылке для регистрации приложения в Microsoft Azure.
В Azure настройте детали регистрации вашего приложения:
- Введите имя регистрации заявки.
- Установите поддерживаемые типы аккаунтов на Multiple Entra ID арендаторов и разрешите всем арендаторам.
Нажмите кнопку "Зарегистрировать".
Запишите отображаемые идентификаторы приложения (клиента) и идентификатор арендатора.
В разделе «Сертификаты и секреты» создайте новый клиентский секрет.
Запишите отображаемое значение секрета клиента.
Вернитесь на страницу интеграции Консоль управления и Chat на вашем экземпляре GitHub Enterprise Server.
Нажмите «Развернуть в Azure» и следуйте инструкциям, чтобы настроить бота Teams в Microsoft Azure.
В Azure выберите группу подписки и ресурсов для бота Azure, который будет развернут.
Введите идентификатор приложения (клиента) и идентификатор арендатора, которые вы записали ранее, в конфигурацию бота Teams.
В зависимости от конфигурации вашей сети для GitHub Enterprise Server:
- Если ваш экземпляр доступен в публичном интернете, выберите галочку Приложить '_msteams' для отметки пути .
- Если ваш экземпляр недоступен в публичном интернете и требует прокси:
  - Убедитесь, что галочка «Добавить _msteams» к пути не выбрана.
  - В поле GHES Instance Host Name введите URL, который передаст трафик на ваш экземпляр.
Нажмите вкладку «Просмотр + создать », затем нажмите «Создать », чтобы сохранить настройки и начать настраивать приложение.
Ждите, пока бот Teams будет запущен в Azure.

Настройте GitHub Enterprise Server и установите приложение в Teams

Вернитесь на страницу интеграции Консоль управления и Chat на вашем экземпляре GitHub Enterprise Server.
Введите Microsoft client ID, Microsoft client secret и Microsoft tenant ID , используя ранее записанные данные приложения.
Опционально, если ваш экземпляр GitHub Enterprise Server недоступен в публичном интернете и требует прокси, введите URL, который переадресует трафик на ваш экземпляр, в поле Public Endpoint URL .

       **Нажмите «Сохранить настройки клиента**».

       **Нажмите «Создать манифест**», чтобы скачать манифест интеграции для последующего использования.

       **Нажмите «Сохранить настройки**», чтобы применить изменения к вашему экземпляру.

Войдите в свой клиент Teams и откройте административный центр Teams.
Перейдите в приложения > Teams Управление приложениями и нажмите Загрузить , чтобы загрузить манифест интеграции, который вы скачали на предыдущем шаге. Для получения дополнительной информации смотрите раздел «Загрузить ваше приложение в Teams».
Установите приложение в Teams и запустите @GHE signin его, чтобы подключить аккаунт GitHub.

Дополнительные материалы

        [AUTOTITLE](/integrations/how-tos/teams/use-github-in-teams) — Узнайте, как использовать интеграцию GitHub для Teams.

        [AUTOTITLE](/integrations/how-tos/teams/customize-notifications) — Узнайте, как настраивать уведомления GitHub в Teams.